Investigations¶
An investigation gathers the events related to an incident in one place (for example, every read of a suspicious vehicle), together with the operator's notes. Each event is kept as frozen evidence: even if the original event changes later, the case copy does not, and everything is logged in a verifiable chain of custody.
Step 1: Find the events in a report¶
- Open Reports and Metrics and build the report in the Events View (see Create, customize and schedule reports).
- Tick the rows that belong to the incident with the checkbox on the left. The selection is kept across pages.
Step 2: Add the events to an investigation¶
- Click Add to investigation.
- In the Add N events to an investigation dialog, choose:
- An open investigation: search for it by title and select it.
- A new investigation: enter a title, for example Suspicious vehicle at the north gate.
- Confirm. The message N events added to "…" appears, with an Open investigation button.
Events already in that investigation are not duplicated.
Step 3: Work the investigation¶
Open Reports and Metrics → Investigations (route /investigations). The list shows each case with its Last activity and can be searched by title or description. You can also start an empty case with New investigation.
An investigation has three tabs:
| Tab | What it is for |
|---|---|
| Evidence (N) | The case events, as they were when added. Each one carries its SHA-256 fingerprint. Remove evidence takes an event out of the case and asks for a reason; the event stays on record as removed and can be shown with Show removed evidence. |
| Notes (N) | What you saw, who you asked, what is still missing. Use Add note. Notes cannot be edited or deleted: to correct one, add another. |
| Chain of custody | A log of every action: who created, edited, closed or reopened the case, and who added or removed evidence, added notes or exported. |
The chain of custody shows an integrity indicator:
- The record is intact: each entry carries the fingerprint of the one before it, and all of them still match.
- The record was altered: at least one entry no longer matches its fingerprint. Report it to the administrator.
Open the report it came from goes back to the reports screen with the filters used to find the evidence.
Step 4: Close, reopen and export¶
- Closing the investigation stops new evidence and notes. Reopen allows them again. Both actions are logged in the chain of custody.
- Export evidence produces a CSV or Excel file with the case events, through the export queue described in Export data.