Use the audit log

Still need help?

The Atlassian Community is here for you.

Ask the community

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 may have been performed in the last 90 days.

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.

Note that audit log entries are stored for 90 days; entries older than this are removed from the log and can't be recovered.

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 then 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, lots of audit logs can build up over time impacting your Jira database performance and clogging up your disk space. You can configure your audit log to delete such entries regularly. For more info, see Expire audit log items.

Last modified on Jun 21, 2022

Was this helpful?

Yes
No
Provide feedback about this article

In this section

Powered by Confluence and Scroll Viewport.