Audit logs

Available for: Enterprise Plan
Set up by: Company Admins

Audit logs allow Company admins to track all the changes made to their Enterprise plan. Logs come in extremely useful when you need to troubleshoot a problem efficiently or to get a detailed report of important events (e.g. changes to the global security settings, invitations of new users, new boards created, etc.). 

✏️ Currently, the events are logged from the moment of the Enterprise subscription creation and are stored endlessly:
a) if you upgrade to Enterprise from a different plan, the events will be logged from the moment of the upgrade,
b) if you migrate some teams to the Enterprise subscription, the data of those teams will be logged only from the moment when they become a part of the subscription. 

Accessing and filtering audit logs (Private Beta)

To access audit logs, do the following:

1. Go to Company Settings. You can get here by doing either of the following:
   a) On the board, click the Settings icon, and choose Profile settings. You may need to select your company from the pulldown menu in the top-left corner.
   b) From the dashboard, click your avatar in the top-right corner and choose Settings.
2.  On the left-side panel, choose Audit logs.
3. Filter the audit logs by choosing a default Date range, or set a Custom date range and specify the From and To fields. You can also filter by Actor, Event category, and Events. 
   

   ✏️ The option to filter by Actor, Event category, and Events is currently only available to select users in Private Beta. 

   Filtering audit logs by Event category

Click the View events button to see the event details. Time is displayed in ISO 8601 format, local time zone.

Audit Log Details window

You can export the logs to CSV format. Event date and time are provided in ISO 8601 format, UTC time zone. The maximum number of records to be exported at a time is 100.000 events.
To export your logs, click the Export to CSV button.

Deleting audit logs

Admins can set a period of time for audit logs to be deleted. You can choose between 30 or 90 days, six months, or one year. You can also set the logs to never be deleted. 

⚠️ Once audit logs are deleted, they cannot be recovered.

To set a deletion period, do the following:

1. Go into your Admin Settings
   1. On the board, click the Settings icon, and choose Profile settings.
   2. From the dashboard, click your avatar in the top-right corner and choose Settings.
2. Click Audit logs from the left-side panel. 
3. Under Audit logs, click the Settings tab. 
4. Choose an option from the drop-down list of choices. You will be asked to confirm your choice.
   Setting audit logs deletion periods

Events in Audit logs

The audit logs include records about the following categories of the events:

Frequently asked questions