FAI Audit Trail

The Audit Trail provides a comprehensive log of user activities and changes in the FAI platform. It records who performed each action, what was changed, and when it happened, offering full transparency and accountability for system events.

Key Benefits

• Accountability & Compliance: Maintain a clear record of all critical actions for auditing purposes. This helps meet regulatory compliance and internal security standards by showing a traceable history of changes.

• Troubleshooting: Easily identify what changes were made (and by whom) when investigating issues. The Audit Trail accelerates diagnostics by pinpointing recent modifications that could have impacted system behavior.

• Change Tracking: Track configuration changes across devices, sites, accounts, and data. This transparency builds trust and prevents unauthorized or accidental changes from going unnoticed.

• Operational Insight: Gain visibility into user behavior and system usage. By reviewing the audit logs, administrators can understand usage patterns, detect anomalies, or verify that procedures are being followed.

How to Access

Navigate to the Audit Trail page by going to:
(FAI Menu) Administration > Audit Trail.
(This will open the Audit Trail interface, which displays the log of events.)

Who Can Access the Audit Trail

Access to the Audit Trail is restricted to users with the Account Owner role (or equivalent top-level administrative roles). Only account owners can view the full activity log for their account, ensuring that sensitive log information is available only to authorized personnel.

What You See

The Audit Trail page displays a table of all recorded events (actions) in the account. Each row in the table represents a specific event, showing details such as the user who performed the action, the type of action, the asset affected, the date/time of the event, and additional context. This comprehensive view allows you to review changes and activities at a glance.

Table Columns

By default, the Audit Trail table includes the following columns:

Table Filter Options

Use the filter controls at the top of the Audit Trail page to refine which events are shown. Available filters include:

• Account: Narrow down the log to a specific account. (This filter is useful if you manage multiple accounts or a parent account with sub-accounts.)

• User: Show events performed by a particular user.

• Action Type: Select one or more action types to display (for example, filter to only Create events, or only Log In/Log Out events, etc.).

• Application Type: Filter events based on the source application or interface (e.g. only show actions done via the Web Platform, or only via Data Curator, Storm Scope, etc.).

• Asset Type: Filter by the type of asset involved in the action. For example, you can choose to see only actions related to Devices, or only those related to Dashboards, Users, Streams, Samples, and so on. (Multiple asset types can be selected.)

• Date Range: Specify a time range for events using the Created At filter. This allows you to view logs for a particular period (e.g. last 7 days, a specific month, or a custom start/end date).

Combine these filters to quickly find the events you’re interested in. For instance, you might filter to see all Delete actions performed by a certain user this month, or all Updates to Device settings in a specific date range.

Table Controls and Actions

In addition to filtering, the Audit Trail page provides a few controls to help you view and refresh the log data:

• Manage Columns: Open the column manager to customize which columns are visible in the table and in what order. This helps you focus on the most relevant information for your needs.

• Freeze Columns: Pin selected columns to the side of the table so that they remain visible as you scroll horizontally. For example, you might freeze the User and Action Type columns to always see who did what while reviewing other details.

• Refresh: Click the refresh button to reload the Audit Trail data. This will fetch the latest events from the server and update the table, ensuring you have the most up-to-date log (especially useful after recent activity or changes).

Tip: Use the Manage Columns tool to show or hide specific columns and to rearrange their order. You can also freeze one or more columns (pin them to the left) so they remain visible during horizontal scrolling.

Actions Logged by the Audit Trail

The Audit Trail currently captures a wide range of actions across the platform. Specifically, it logs events such as:

• User Login/Logout:
  All user sign-ins and sign-outs are recorded, along with the timestamp and user identity. This helps track access to the system.

• Account Management:
  LoginUser
  LogoutUser
  RemoveUserFromGroup
  RemoveUserGroup
  UpdateGroup
  CreateGroup
  UpdateUser
  CreateUser
  CancelInvitation
  ExtendInvitation
  UpdateOrganizationsForUser
  DeleteUser
  CreateOrganization
  UpdateOrganization
  DeleteOrganization
  AddUserToOrganization
  RemoveUserFromOrganization
  SetAccountPermissions
  DeleteAccountPermissions
  UpdateTechnicalAlertGroup
  DeleteTechnicalAlertGroup
  UpdateTechnicalAlertGroupStatus
  UploadAccountImage
  UpdateAccountSecuritySettings
  CreateCustomAttribute
  UpdateCustomAttribute
  DeleteCustomAttribute

• Sites:
  ArchiveSite
  UpdateSiteLocation
  UpdateDisplayName
  UpdateSiteAccount
  CreateSiteAndDevice

• Subscription:
  UpdateRenewalDate
  UpdateSubscriptionManager
  UpdateSubscriptionManagerUsageAlerts

• Reports:
  CreateReportTask

This list covers the major actions currently tracked by the Audit Trail. Each log entry provides enough detail to understand what occurred, allowing Account Owners to review and verify any critical changes in the system. As the platform evolves, additional event types may be added to the Audit Trail to further extend its oversight capabilities.