Using the audit log

You can use the audit log to check the history of execution of specific rules, either in the context of your project or the entire Jira instance. Every rule has a separate audit log – you can view it in the details of your rule.

View the audit log

View the project’s audit log

  1. In project settings, go to Project automation.

  2. Select … > 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.

View the global audit log

  1. Go to Administration > System > Automation rules (under Automation for Jira). You can also access this page by clicking 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

Starting from version 7.4, 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 Oct 26, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.