Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Asset Groups – Audit Logs

The Audit Logs tab in the Asset Group menu provides detailed visibility into changes made within an Asset Group, tracking both User and System actions over time. This is especially useful for monitoring configuration changes, debugging access issues, and maintaining data integrity across teams.

Purpose and Functionality

The Audit Logs tab allows administrators and users with sufficient permissions to:

  • Review who made changes to the group.

  • See what was changed and when.

  • Identify whether actions were triggered manually or by the system.

  • Trace potential causes of unexpected behaviour.

This tab is divided into two sub-tabs: User and System.

User Tab

This sub-tab displays logs of all actions performed by users interacting with the Asset Group. Each row in the table includes:

Column Description
Date The timestamp when the action occurred
User Email The email of the user who performed the action
User IP Address IP address of the user session
Method HTTP method used (e.g., PUT, POST, DELETE)
Endpoint API endpoint where the change was made
Status HTTP response code (e.g., 200 for success)
Operation Description of the action (e.g., UpdateGroup, AddAsset)

This tab helps verify change accountability and ensures traceability of updates made to group configurations.

System Tab

The System sub-tab (accessible by clicking the "System" toggle at the top) displays logs of automated or background actions initiated by the platform. These can include synchronisation tasks, automated workflows, or system-based asset management events.

System logs follow a similar structure to user logs, though the "User Email" field will indicate a system actor (e.g., system@perspio.io) instead of a real user.

 

Screen Controls

The Audit Logs interface includes several filters and navigation aids to streamline the investigation process:

  • Date Navigation (Top Bar):
    Use the timeline at the top of the screen to move across days. Select a specific date or use the left/right arrows to move backward or forward.

  • View Modes:
    Toggle between D (Day), W (Week), and M (Month) to adjust the date window displayed.

  • Today Button:
    Quickly returns you to the current day's logs.

  • Search Logs:
    Use the search field to filter logs by user email, method, endpoint, or operation.

  • Export Button:
    Download the current logs in CSV format for offline analysis or archiving.

 

For more information on the Date/Time Picker, see this article.

 

Additional Notes

  • All operations performed through the Asset Group interface, including changes to configuration, asset membership, and geofence associations, are logged here.

  • Logs are stored with timestamps in the timezone configured for the tenant, ensuring consistency across the platform.

  • Only users with the appropriate role or permission level will be able to view or export audit logs.