Use the audit log

Each of your rules will have an audit log that you can review to see when the rule was triggered, the final result of the execution, and any actions that have been recently performed.

For each rule execution, the audit log will display:

  • Date: the date and time that the rule was triggered.

  • Rule: the name of the rule.

  • Status: the status of the rule execution.

  • Duration: the length of time the rule took to execute.

  • Operations: the actions that the rule performed and any associated items.

You can view the audit log of an individual rule, project-wide, or at a global level. Reviewing your audit logs is an effective way of debugging your rules

View the audit log

To view the project's audit log:

  1. In project settings, go to Project automation.

  2. Select the more action menu > Show audit log.

  3. Open one of your rules and then switch to Audit log. This audit log will only show entries related to this project.

To view the global audit log:

  1. Go to Administration > System > Automation rules (under Automation for Jira). You can also access this page by selecting Global administration in Automation for Jira.

  2. Open one of your rules and switch to Audit log.

Filter audit log entries

Audit logs can include many historical entries but you can use the filters to narrow them down. You can filter either by status (the result of executing a rule) or date range. Using the filters is especially important if you plan to export your audit log—there are some limitations as to what you can export.

Export audit log entries

You can export your audit log to JSON. Since audit logs can grow quite quickly, there are some limitations to how many entries you can export.

  • You can export up to 30,000 entries but they must be processed within 60 seconds of starting the export. After this time, the export is stopped to avoid performance issues with large audit logs.

  • Unless you use the status filter, the export can contain entries from 7 days. We generally count the days since the end date you specify in the date filter. If you don’t use this filter, the end date is current time.

  • If you use the status filter, the 7-day limit won’t be applied, so you can export all entries with a specific status.

To export the audit log:

  1. Open the audit log for a rule.

  2. Use the status and date filters to narrow down the list of results.

  3. Select Export.

Expire audit log entries

On large instances, audit logs can build up over time and impact your Jira database performance by clogging up your disk space. To prevent that, we recommend configuring your audit log to delete audit log items regularly. Learn more about expiring audit log items

Last modified on Jan 27, 2023

Was this helpful?

Yes
No
Provide feedback about this article

In this section

Powered by Confluence and Scroll Viewport.