aware

History — Events

Manual

The Events section provides a searchable, paginated audit log of all device events recorded by the system — access grants/denials, object detections, device commands, agent lifecycle changes, call state changes, and notifications. You can filter by device, person, event type, and time range, export results to PDF, and inspect individual events alongside linked camera footage.


Page Structure

┌──────────────────────────────────────────────────────────────────────┐
│  Filter bar                                                          │
│  - "Filter Events" when no filters active                            │
│  - Active filters shown as deletable chips                           │
├────────────────────┬─────────────────────────────────────────────────┤
│  Toolbar (right)   │  Event list (paginated table)                   │
│  - Refresh button  │  Columns: Timestamp | Device | Event | Person   │
│  - Export PDF      │  Alarm-trigger rows: red highlight              │
│                    │  Selected row: blue highlight                   │
├────────────────────┴─────────────────────────────────────────────────┤
│  Event Detail panel (shown when event selected)                      │
└──────────────────────────────────────────────────────────────────────┘

Filter Bar

Clicking the filter bar (or any active filter chip) opens the Filter Events Dialog.

Filter Events Dialog

Field Description
Devices Select specific devices
Persons Select specific people whose events to show
Event Type Select one or more event kinds
Alarm Triggers Only Show only events that triggered an alarm
Time From Lower time bound
Time To Upper time bound

Clicking Apply resets pagination to page 1 and closes the dialog. Individual filter chips can be removed without reopening the dialog.


Toolbar Controls

Refresh

New events arriving while the page is open are counted silently in the background. The Refresh button shows a badge with the count. Clicking it re-runs the current query and resets the counter.

Export to PDF

Exports the current filtered results (up to 10,000 rows) as events-export.pdf. If the result set exceeds 10,000, a warning is shown but the export still proceeds with the first 10,000 events.


Event List

Column Content
Timestamp Date and time of the event
Device Device name, or “Unknown Device (deleted)” if the device was removed
Event Human-readable event description
Person Person associated with the event, where applicable

Clicking a row opens the Event Detail Panel at /events/:id while preserving all current filter parameters.

Event Descriptions

Event Kind Description Shown
door-access (allowed, no token) “Opened” or “Door Exit”
door-access (allowed, with token) “Accessed”
door-access (denied) “Access Denied”
device-command “Command: [description]”
object-detection-started “[object] In View”
object-detection-ended “[object] Out of View”
agent-started / agent-stopped “Agent Started/Stopped: [name]”
notification-created Notification: "[message]"
All others Standard event kind label

Event Detail Panel

Opens when a row is selected. Two tabs:

Summary Tab

Field Content
Time Full formatted timestamp
Device Device name
Subject Person or user associated with the event

If the event’s device has an associated camera, a footage playback widget appears below the properties — seeked to the exact event timestamp (±30 minutes of recording). If no recording is available, a warning is shown.

Raw Tab

Displays the complete raw JSON payload of the event. Useful for debugging or inspecting unlisted fields.



Back to Manual