Audit activities in Jira
Audit logs track key activities in Jira that can be viewed in the Jira administration console. This helps with diagnosing problems and maintaining security. To view the audit log you need to have the Administer Jira global permission. Read how to change permissions.
The audit log isn't available if all of your Jira Cloud products are on the Free plan.
View the audit log
Choose Settings > System
Choose Audit Log
The following events are captured in the audit log:
Category | Events |
|---|---|
Auditing | Auditing enabled, auditing disabled |
Project changes | Project created, project removed, project updated |
Permission changes | Scheme created, scheme copied, scheme removed, scheme edited, scheme assigned to a project, scheme unassigned from a project, permission added to scheme, permission removed from scheme, global permission added to a group, global permission removed from a group |
Workflow changes | Scheme created, scheme copied, scheme removed, scheme edited, scheme assigned to a project, scheme unassigned from a project, workflow created, workflow copied, workflow removed, workflow renamed, workflow draft published |
Notification changes | Scheme created, scheme copied, scheme removed, scheme edited, scheme added to project, scheme removed from project, notification added to scheme, notification removed from scheme. |
Screen changes | Screen created, Screen copied, Screen edited, Screen deleted, Field added to screen, Field removed from screen, Tab added to Screen, Tab updated in Screen, Tab removed from screen |
Custom field changes | Custom field created, custom field updated, scheme added to project, scheme removed from project, custom field trashed, custom field restored, custom field deleted |
Plan changes | Plan created, plan deleted, plan updated (includes scheduling configurations, adding or removing work sources, and changing of exclusion rules), plan permission changes |
Sprint changes | Sprint created, sprint started, sprint updated, sprint closed, sprint deleted, sprint deleted |
Work item delete | Tracked by work item number |
Work type changes | Work Type created, Work Type updated, Work Type deleted |
Screen scheme changes | Screen scheme created, Screen scheme copied, Screen scheme edited, Screen scheme deleted, work item operation added to a Screen in Screen scheme, work item operation removed from a Screen in Screen Scheme |
Work type screen scheme changes | Work type screen scheme created, Work type screen scheme edited, Work type screen scheme deleted, Work Type screen scheme copied, Work type associated to a screen scheme, Work type association updated to a different screen scheme, Work type association removed from a screen scheme |
Work type scheme changes | Work type scheme created, Work type scheme updated, Work type scheme deleted, Work type scheme copied, Work type scheme associated to a project, Work type scheme removed from a project |
Field configuration changes | Field configuration created, Field configuration edited, Field configuration deleted, Field configuration copied, Field configuration changes for a field for hide/show, required/optional or change of description |
The audit log isn't intended to record all activity in Jira. The audit log is intended to record configuration changes that can impact users and projects.
You can't sort the audit log. You can export the data to a CSV file and open it in a spreadsheet application to manipulate the data.
There's a known work item which prevents the Author field from displaying the username for changes that were made in the user management pages in Jira cloud products (including changes to users, groups, and application access). For example, events like users being created or assigned to groups won't include the username of the user who made the change.
Edit audit log settings
You can configure how long audit events are retained, and whether events from external user directories like LDAP appear in the log.
Select Actions > Audit Log Settings.
Choose your retention period e.g. 6 months.
Update the retention period and external user directory settings and choose Save.
Export the audit log
You can export up to 100,000 events as a CSV file. If you have more than 100,000 events, the newest events are included in the export.
When you export the audit log, all events (up to the maximum number) are included even if you've filtered the audit log results in the page.
Navigate to the audit log and choose Export.
Confirm by selecting Export again.
Auditing and the REST API
The audit log can also be accessed via the REST API. You may use this to:
Export the audit log
Add events to the audit log triggered by external plugins
For more information on using the REST API, check out the Jira Cloud REST API documentation.
Was this helpful?