Auditing in JIRA
About auditing in JIRA
The auditing feature tracks key activities in JIRA. These activities are recorded in an audit log that can be viewed in the JIRA administration console. This can be a handy tool in helping you diagnose problems in JIRA or used for security purposes.
The following information is audited by JIRA:
- user management
- group management
- project changes
- permission changes
- workflow changes
- notification scheme changes
- custom field changes
- component changes
- version changes
The audit log is not intended to record all activity in JIRA, as can be seen above. For example, it does not track issue updates or pages that are viewed by a user. Rather, the audit log is intended to record configuration changes that can impact users and projects. The full list of events recorded can be seen below.
Auditing in JIRA is disabled by default. See below for instructions on how to enable it.
On this page:
Viewing the audit log
To view the audit log in JIRA:
- Log in as a user with the JIRA System Administrators global permission.
- Choose
> Audit Log. 
Keyboard shortcut: g + g + type Auditing The following events are audited:
Category Events User management user added, user removed, user changed Group management group added, group removed, user added to group, user removed from group Project changes project created, project removed, project updated, project category changed, project avatar changed 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 Custom field changes custom field created, custom field updated, custom field removed, scheme added to project, scheme removed from project Component changes component created, component edited, component deleted Version changes version created, version edited, version deleted, version merged, version archived/unarchived, version released/unreleased
Notes:
- The date and time displayed by the audit log is based on the timezone of the host JIRA server, and not on the viewer's timezone.
- The audit log cannot be sorted. Try exporting the data and opening it in a spreadsheet to manipulate the data.
- The export function only allows you to export the full audit log, even if you have filtered the audit log.
- The export function only allows you to export the audit log to text.
You will prompted to choose a location to save the results, when exporting the audit log.
Enabling the audit log
To enable auditing in JIRA:
- Log in as a user with the JIRA System Administrators global permission.
- Choose > System > Audit Settings. Keyboard shortcut: g + g + type Audit Settings
- Click Enable.