Audit Logs

v2.20.1

The Audit Logs tab is the system change log. Every create, update, and delete operation performed on entities in the system - users, licences, devices, cameras, schedules, and more - is recorded here with the actor, the timestamp, and the exact before and after values.

Path: Events → Audit Logs

Access restricted: The Audit Logs tab is visible only to BU Admins and Administrators. Users with the plain User role do not see this tab or its navigation button.

Interface

No.	Section	Description
1	Tab switcher	Pill buttons to switch between Alarms and Audit Logs
2	Toolbar	Export, search, and column settings buttons
3	Audit log table	Infinite-scroll grid of system change records, newest first
4	Expanded row	Previous → current diff panel for the selected change record
5	Filter drawer	Collapsible sidebar with five filter categories

Action	Description	When available
Toggle filters	Opens or closes the filter drawer	Always
Export to PDF	Exports the first seven columns of the current filtered result set as a landscape PDF. The Description column is excluded from the export	Only when the table has at least one row
Export to Excel	Exports the first seven columns of the current filtered result set as an Excel spreadsheet. The Description column is excluded from the export	Only when the table has at least one row
Search	Opens a search box. Type to filter the visible rows and highlight matches. Search is sent to the server and applied to the table simultaneously	Disabled when the table has no rows
Column settings	Opens the column visibility and order dialog	Always

The search box is only available on the Audit Logs tab. The Alarms tab uses its filter drawer for narrowing results instead.

Table columns

Column	Description
Audit code	Unique identifier for the audit log entry
Created on	Date and time the change was made
Created by	The user who performed the action. Shows system for changes made by the licence activator or a superadmin
Action	The type of operation: Create, Update, or Delete (shown as a coloured badge)
Model	The type of entity that was changed (e.g. User, Device, Camera, Licence, Schedule)
Event	The specific event name describing what happened (e.g. User updated, Licence activated)
Subject	The name or description of the specific entity that was changed
Description	A detailed HTML summary of the change. Hover to preview the changed values in a popover. Click the row to see the full previous → current diff panel

The Action badge

The Action column shows a coloured status badge:

Badge	Meaning
Create	A new entity was created
Update	An existing entity was modified
Delete	An entity was deleted

Filters

Open the filter drawer by clicking the filter icon at the top left of the page. Five filter categories are available for the Audit Logs tab.

#	Filter	Type	What it filters
1	Calendar	Single-day picker	Shows changes from the selected day. Mutually exclusive with the Date range filter
2	Date	Date range picker	Shows changes within the selected from/to range. Selecting a range clears the Calendar selection
3	Alarms	Grouped tree, multi-select	Changes of the selected event type, grouped by entity category (User, Licence, Licence Activator, API Keys)
4	Created by	User picker	Changes performed by the selected user (the actor who made the change)
5	Users	User picker	Changes made to the selected user or entity (the subject of the change)

Created by vs Users: These two filters are easy to confuse. Created by filters by the person who performed the change. Users filters by the entity that was changed. For example, to see all changes an administrator made, use Created by. To see all changes made to a specific user’s account, use Users.

Filter selections and the expanded or collapsed state of each filter group are saved in your browser and restored on your next visit.

Search

The search box in the toolbar filters the Audit Logs table by free text. The search term is sent to the server and applied to the table simultaneously, with matching text highlighted in the results.

The search box is disabled when the table contains no rows. There is no search function on the Alarms tab - use the filters there instead.

Hover over any row’s Description cell to see a quick preview of the changed values in a popover. The popover is loaded lazily on hover. Its title shows Previous for delete-type records, or Current for all other change types.

The popover stays open while your cursor is over it, so you can read longer descriptions without moving away.

Previous → current diff panel

Click any row in the table to expand it. The detail panel opens below the row and shows the full before and after state of every changed property side by side.

The panel layout:

Previous value         →         Current value
──────────────────────────────────────────────
[property: old value]     [property: new value]
[property: old value]     [property: new value]
…

For Create records, only the current values are shown (there is no previous state). The panel displays a No previous data placeholder on the left side.

For Delete records, only the previous values are shown. The panel displays a No current data placeholder on the right side.

Value rendering

Each changed value is rendered based on its type:

Value type	How it is displayed
Plain text	Shown as-is
Licence type	Shown as a coloured status badge (Active, Expired, Inactive, Trial, Paused, Unpaired)
Array change	Each added item is shown with a green check icon; each removed item is shown with a red X icon. Used for role changes, group assignments, location permissions, and schedule assignments
Date / time	Formatted to the system date format

Array diffs are particularly useful for reviewing permission changes. For example, when a user’s roles or location access permissions are updated, you can see exactly which roles or locations were added and which were removed.