Audit Trail Display
The Audit Trail display is used to retrieve and visualize Audit Trail Records for the system and individual objects. The Audit Trail feature creates a full record of every object configuration change, external write and component launch/update/connection in the system.
Before using Audit Trail, it is first necessary to Enable the Audit Trail Features as system administrator and select the Audit Trail changes that should be recorded. Once enabled, Audit Trail records can be visualized in the Audit Trail display.
The Audit Trail display can be opened from the Open menu () or from the context menu of an object in a model panel by right clicking and selecting .
Depending on when the Audit Trail features were enabled, some audit trail entries may already be visible. If the Audit Trail display was opened from the context menu for a particular object, then only the Audit Trail records for that object will be displayed.
Menubar Options
The available menu bar options are as follows:
| Element | Shortcut | Action |
|---|---|---|
|
F5 |
Refresh grid based on current time settings |
|
Ctrl+Shift+E |
Exports the current contents of the grid into selected file format and opens the file |
|
F6 |
Opens Time Period Setting dialogue |
Object Filter box |
- |
Displays the name of any objects added to the display. Grid will then filter entries to display those corresponding to the object names. |
|
Ctrl+Alt+R |
Automatically resizes all columns to fit content |
Max Lines selector |
- |
Enter the maximum number of lines that should be displayed in the grid |
Filter Time |
- |
Start and End Time for the currently displayed audit trail query |
The footer of the Audit Trail Display contains fields giving information about the returned records and the times that queries were made. These fields are described below.
| Field | Description |
|---|---|
Returned Time |
Time range of returned data (timestamps of the first and last records returned in query). |
Query Time |
Time that the query was made. |
Records |
Number of records returned in the query. |
Selecting Columns and Adding Objects and Filters
The columns displayed in the grid can be changed by clicking on the column selector icon 
.
Dragging and dropping objects from the model panels will apply filters to the grid display, only displaying entries associated with those objects.
The filters can be cleared by clicking on the object filter box in the menubar and clicking the delete icon 
.
Examining Audit Trail Entries and Comparing Versions
Individual entries in the Audit Trail display can be examined further by using the available options in the context menu. To do this, select an entry and right-click.
The audit trail entry can be opened in the JSON viewer to examine the record elements directly.
From the context menu, you can select to compare the record entry with the previous config version or with the current version. Selecting either of these options will open up the version difference viewer.
The difference dialog displays the chosen Audit Trail record entry and a comparison with either a previous config version or the current version. In the case of object configuration changes, the difference viewer shows the current and previous config versions of the object, represented as the syslib.mass Lua script needed to create the fully configured objects. The left column contains the previous config version and the right column the current version. The additions or deletions are highlighted in green and red respectively.
The menubar options in the difference viewer allow you to navigate forwards and backwards through the different changes between the two config versions (making the change visible in the viewer without having to scroll). Using the find function, you can search for particular elements in the config versions.
