2020-05-07 21:09:26 +00:00
---
2020-06-08 18:08:27 +00:00
stage: Manage
2020-07-22 21:09:50 +00:00
group: Compliance
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-05-07 21:09:26 +00:00
---
2021-02-04 18:09:22 +00:00
# Audit Events **(PREMIUM)**
2019-05-05 15:21:25 +00:00
2021-06-15 18:09:57 +00:00
GitLab offers a way to view the changes made within the GitLab server for owners and administrators
on a [paid plan ](https://about.gitlab.com/pricing/ ).
2019-05-05 15:21:25 +00:00
2021-12-10 00:13:05 +00:00
GitLab system administrators can also view all audit events by accessing the [`audit_json.log` file ](logs.md#audit_jsonlog ).
2022-05-09 00:07:52 +00:00
The JSON audit log does not include events that are [only streamed ](../development/audit_event_guide/index.md#event-streaming ).
2019-05-05 15:21:25 +00:00
2021-11-09 03:42:22 +00:00
You can:
- Generate an [audit report ](audit_reports.md ) of audit events.
- [Stream audit events ](audit_event_streaming.md ) to an external endpoint.
2020-11-10 18:09:07 +00:00
2019-05-05 15:21:25 +00:00
## Overview
2020-02-20 18:08:51 +00:00
**Audit Events** is a tool for GitLab owners and administrators
to track important events such as who performed certain actions and the
time they happened. For example, these actions could be a change to a user
2019-05-05 15:21:25 +00:00
permission level, who added a new user, or who removed a user.
2020-02-20 18:08:51 +00:00
## Use cases
2019-05-05 15:21:25 +00:00
2020-02-20 18:08:51 +00:00
- Check who changed the permission level of a particular
user for a GitLab project.
- Track which users have access to a certain group of projects
in GitLab, and who gave them that permission level.
2019-05-05 15:21:25 +00:00
2021-12-08 03:10:32 +00:00
## Retention policy
There is no retention policy in place for audit events.
2022-04-20 06:08:45 +00:00
See the [Specify a retention period for audit events ](https://gitlab.com/groups/gitlab-org/-/epics/7917 ) for more information.
2021-12-08 03:10:32 +00:00
2019-05-05 15:21:25 +00:00
## List of events
There are two kinds of events logged:
2020-02-20 18:08:51 +00:00
- Events scoped to the group or project, used by group and project managers
to look up who made a change.
2019-05-05 15:21:25 +00:00
- Instance events scoped to the whole GitLab instance, used by your Compliance team to
perform formal audits.
2022-03-17 03:08:05 +00:00
NOTE:
Some events are recorded and available only as [streaming audit events ](audit_event_streaming.md ).
2021-02-12 21:09:01 +00:00
### Impersonation data
2020-05-15 15:08:04 +00:00
2021-09-07 15:11:06 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/536) in GitLab 13.0.
2020-05-15 15:08:04 +00:00
2021-02-12 21:09:01 +00:00
When a user is being [impersonated ](../user/admin_area/index.md#user-impersonation ), their actions are logged as audit events as usual, with two additional details:
2022-02-18 15:15:51 +00:00
1. Usual audit events include information about the impersonating administrator. These audit events are visible in their
respective audit event pages depending on their type (group, project, or user).
1. Extra audit events are recorded for the start and stop of the administrator's impersonation session. These audit events
are visible in the:
2022-02-10 15:12:42 +00:00
- Instance audit events.
2022-02-18 15:15:51 +00:00
- Group audit events for all groups the user belongs to (GitLab 14.8 and later). For performance reasons, group audit
events are limited to the oldest 20 groups to which you belong.
2021-02-12 21:09:01 +00:00
![audit events ](img/impersonated_audit_events_v13_8.png )
2020-05-15 15:08:04 +00:00
2021-09-07 15:11:06 +00:00
### Group events
2019-05-05 15:21:25 +00:00
2021-06-11 00:10:14 +00:00
A user with:
- Owner role (or above) can retrieve group audit events of all users.
- Developer or Maintainer role is limited to group audit events based on their individual actions.
Group events do not include project audit events.
2019-05-05 15:21:25 +00:00
2021-06-15 18:09:57 +00:00
To view a group's audit events:
1. Go to the group.
1. On the left sidebar, select **Security & Compliance > Audit Events** .
2019-05-05 15:21:25 +00:00
From there, you can see the following actions:
2020-08-18 06:10:30 +00:00
- Group name or path changed.
- Group repository size limit changed.
- Group created or deleted.
- Group changed visibility.
- User was added to group and with which [permissions ](../user/permissions.md ).
- User sign-in via [Group SAML ](../user/group/saml_sso/index.md ).
2021-11-16 06:12:13 +00:00
- [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/8071 ) in GitLab 14.5, changes to the following
[group SAML ](../user/group/saml_sso/index.md ) configuration:
- Enabled status.
- Enforcing SSO-only authentication for web activity.
- Enforcing SSO-only authentication for Git and Dependency Proxy activity.
- Enforcing users to have dedicated group-managed accounts.
- Prohibiting outer forks.
- Identity provider SSO URL.
- Certificate fingerprint.
- Default membership role.
- SSO-SAML group sync configuration.
2020-08-18 06:10:30 +00:00
- Permissions changes of a user assigned to a group.
- Removed user from group.
- Project repository imported into group.
2019-05-05 15:21:25 +00:00
- [Project shared with group ](../user/project/members/share_project_with_groups.md )
2020-08-18 06:10:30 +00:00
and with which [permissions ](../user/permissions.md ).
- Removal of a previously shared group with a project.
- LFS enabled or disabled.
- Shared runners minutes limit changed.
- Membership lock enabled or disabled.
- Request access enabled or disabled.
- 2FA enforcement or grace period changed.
- Roles allowed to create project changed.
- Group CI/CD variable added, removed, or protected status changed. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/30857 ) in GitLab 13.3.
2021-11-18 09:10:16 +00:00
- Compliance framework created, updated, or deleted. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/340649 ) in GitLab 14.5.
2021-11-25 09:13:54 +00:00
- Event streaming destination created, updated, or deleted. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/344664 ) in GitLab 14.6.
2022-02-10 15:12:42 +00:00
- Instance administrator started or stopped impersonation of a group member. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/300961 ) in GitLab 14.8.
2022-03-09 21:07:04 +00:00
- Group deploy token was successfully created, revoked, or deleted. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/353452 ) in GitLab 14.9.
- Failed attempt to create a group deploy token. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/353452 ) in GitLab 14.9.
2022-06-07 21:09:00 +00:00
- [IP restrictions ](../user/group/index.md#group-access-restriction-by-ip-address ) changed. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/358986 ) in GitLab 15.0.
2022-05-12 12:08:30 +00:00
- Changes to push rules. [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/227629 ) in GitLab 15.0.
2022-06-15 15:09:20 +00:00
- [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/356152 ) in GitLab 15.1, changes to the following merge request approvals settings:
- Prevent approval by author.
- Prevent approvals by users who add commits.
- Prevent editing approval rules in projects and merge requests.
- Require user password to approve.
- Remove all approvals when commits are added to the source branch.
2019-05-05 15:21:25 +00:00
2020-09-07 15:09:04 +00:00
Group events can also be accessed via the [Group Audit Events API ](../api/audit_events.md#group-audit-events )
2019-11-15 03:06:34 +00:00
2021-09-07 15:11:06 +00:00
### Project events
2019-05-05 15:21:25 +00:00
2020-12-16 15:10:18 +00:00
A user with a Maintainer role (or above) can retrieve project audit events of all users.
A user with a Developer role is limited to project audit events based on their individual actions.
2019-05-05 15:21:25 +00:00
2021-06-15 18:09:57 +00:00
To view a project's audit events:
1. Go to the project.
1. On the left sidebar, select **Security & Compliance > Audit Events** .
2019-05-05 15:21:25 +00:00
From there, you can see the following actions:
2020-02-20 18:08:51 +00:00
- Added or removed deploy keys
2020-06-26 15:08:45 +00:00
- Project created, deleted, renamed, moved (transferred), changed path
2019-05-05 15:21:25 +00:00
- Project changed visibility level
2020-04-21 15:21:10 +00:00
- User was added to project and with which [permissions ](../user/permissions.md )
2019-05-05 15:21:25 +00:00
- Permission changes of a user assigned to a project
- User was removed from project
2019-07-24 14:15:50 +00:00
- Project export was downloaded
- Project repository was downloaded
2019-08-21 03:42:48 +00:00
- Project was archived
- Project was unarchived
2020-02-20 18:08:51 +00:00
- Added, removed, or updated protected branches
2020-01-10 18:07:43 +00:00
- Release was added to a project
- Release was updated
- Release milestone associations changed
2020-05-21 06:08:25 +00:00
- Permission to approve merge requests by committers was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7531) in GitLab 12.9)
2021-11-19 03:14:18 +00:00
- Permission to approve merge requests by committers was updated.
- [Introduced ](https://gitlab.com/gitlab-org/gitlab/-/issues/7531 ) in GitLab 12.9.
- Message for event [changed ](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/72623/diffs ) in GitLab 14.6.
2020-05-21 06:08:25 +00:00
- Permission to approve merge requests by authors was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7531) in GitLab 12.9)
- Number of required approvals was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7531) in GitLab 12.9)
2020-07-13 18:09:16 +00:00
- Added or removed users and groups from project approval groups ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/213603) in GitLab 13.2)
2020-10-23 18:08:31 +00:00
- Project CI/CD variable added, removed, or protected status changed ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/30857) in GitLab 13.4)
2021-01-22 21:09:10 +00:00
- Project access token was successfully created or revoked ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/230007) in GitLab 13.9)
- Failed attempt to create or revoke a project access token ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/230007) in GitLab 13.9)
2021-02-02 00:09:14 +00:00
- When default branch changes for a project ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/52339) in GitLab 13.9)
2021-07-06 00:08:15 +00:00
- Created, updated, or deleted DAST profiles, DAST scanner profiles, and DAST site profiles
([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/217872) in GitLab 14.1)
2021-07-09 15:09:47 +00:00
- Changed a project's compliance framework ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/329362) in GitLab 14.1)
2021-08-10 09:10:08 +00:00
- User password required for approvals was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/336211) in GitLab 14.2)
- Permission to modify merge requests approval rules in merge requests was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/336211) in GitLab 14.2)
- New approvals requirement when new commits are added to an MR was updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/336211) in GitLab 14.2)
2021-09-02 06:09:10 +00:00
- When [strategies for feature flags ](../operations/feature_flags.md#feature-flag-strategies ) are changed ([introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/68408) in GitLab 14.3)
2021-09-14 06:11:25 +00:00
- Allowing force push to protected branch changed ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/338873) in GitLab 14.3)
- Code owner approval requirement on merge requests targeting protected branch changed ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/338873) in GitLab 14.3)
- Users and groups allowed to merge and push to protected branch added or removed ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/338873) in GitLab 14.3)
2022-03-07 03:18:52 +00:00
- Project deploy token was successfully created, revoked or deleted ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/353451) in GitLab 14.9)
- Failed attempt to create a project deploy token ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/353451) in GitLab 14.9)
2022-04-26 03:10:58 +00:00
- When merge method is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Merged results pipelines enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Merge trains enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Automatically resolve merge request diff discussions enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Show link to create or view a merge request when pushing from the command line enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Delete source branch option by default enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Squash commits when merging is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Pipelines must succeed enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Skipped pipelines are considered successful enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- All discussions must be resolved enabled or disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
- Commit message suggestion is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/301124) in GitLab 14.9)
2022-04-27 12:08:19 +00:00
- Status check is added, edited, or deleted ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/355805) in GitLab 15.0)
- Merge commit message template is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/355805) in GitLab 15.0)
- Squash commit message template is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/355805) in GitLab 15.0)
- Default description template for merge requests is updated ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/355805) in GitLab 15.0)
2022-05-17 03:09:07 +00:00
- Project was scheduled for deletion due to inactivity ([introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/85689) in GitLab 15.0)
2019-05-05 15:21:25 +00:00
2020-10-23 18:08:31 +00:00
Project events can also be accessed via the [Project Audit Events API ](../api/audit_events.md#project-audit-events ).
2020-06-04 00:08:17 +00:00
2021-01-13 00:10:50 +00:00
Project event queries are limited to a maximum of 30 days.
2021-01-28 12:09:54 +00:00
### Instance events **(PREMIUM SELF)**
2019-05-05 15:21:25 +00:00
2020-12-14 06:09:41 +00:00
Server-wide audit events introduce the ability to observe user actions across
2019-05-05 15:21:25 +00:00
the entire instance of your GitLab server, making it easy to understand who
changed what and when for audit purposes.
2021-06-11 00:10:14 +00:00
Instance events do not include group or project audit events.
2021-06-15 18:09:57 +00:00
To view the server-wide audit events:
2021-08-26 00:09:31 +00:00
1. On the top bar, select **Menu > Admin** .
2021-06-15 18:09:57 +00:00
1. On the left sidebar, select **Monitoring > Audit Events** .
2019-05-05 15:21:25 +00:00
2021-06-11 00:10:14 +00:00
The following user actions are recorded:
2019-05-05 15:21:25 +00:00
2020-02-20 18:08:51 +00:00
- Sign-in events and the authentication type (such as standard, LDAP, or OmniAuth)
2020-10-23 18:08:31 +00:00
- Failed sign-ins
2019-05-05 15:21:25 +00:00
- Added SSH key
2020-02-20 18:08:51 +00:00
- Added or removed email
2019-05-05 15:21:25 +00:00
- Changed password
- Ask for password reset
- Grant OAuth access
2020-02-20 18:08:51 +00:00
- Started or stopped user impersonation
2020-05-21 06:08:25 +00:00
- Changed username ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/7797) in GitLab 12.8)
- User was deleted ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/251) in GitLab 12.8)
- User was added ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/251) in GitLab 12.8)
2021-01-28 06:08:59 +00:00
- User requests access to an instance ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/298783) in GitLab 13.9)
- User was approved via Admin Area ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/276250) in GitLab 13.6)
- User was rejected via Admin Area ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/298783) in GitLab 13.9)
2020-05-21 06:08:25 +00:00
- User was blocked via Admin Area ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/251) in GitLab 12.8)
2020-03-04 12:07:52 +00:00
- User was blocked via API ([introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/25872) in GitLab 12.9)
2020-09-30 03:09:46 +00:00
- Failed second-factor authentication attempt ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/16826) in GitLab 13.5)
2020-11-09 12:09:24 +00:00
- A user's personal access token was successfully created or revoked ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/276921) in GitLab 13.6)
- A failed attempt to create or revoke a user's personal access token ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/276921) in GitLab 13.6)
2021-07-01 15:07:40 +00:00
- Administrator added or removed ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/323905) in GitLab 14.1)
2021-07-09 09:09:53 +00:00
- Removed SSH key ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/220127) in GitLab 14.1)
2021-07-14 21:09:44 +00:00
- Added or removed GPG key ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/220127) in GitLab 14.1)
2022-06-17 06:08:15 +00:00
- A user's two-factor authentication was disabled ([introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/238177) in GitLab 15.1)
2019-05-05 15:21:25 +00:00
2020-10-23 18:08:31 +00:00
Instance events can also be accessed via the [Instance Audit Events API ](../api/audit_events.md#instance-audit-events ).
2019-11-15 03:06:34 +00:00
2021-06-02 00:09:56 +00:00
### Sign-in events **(FREE)**
Successful sign-in events are the only Audit Events available at all tiers. To see
successful sign-in events:
1. Select your avatar.
1. Select **Edit profile > Authentication log** .
After upgrading from GitLab Free to a paid tier, successful sign-in events are the only Audit
Events visible in Audit Events views until more events are logged.
2021-11-04 06:09:57 +00:00
### "Deleted User" events
2021-12-03 15:10:36 +00:00
Audit events can be created for a user after the user is deleted. The user name associated with the event is set to
2021-11-04 06:09:57 +00:00
"Deleted User" because the actual user name is unknowable. For example, if a deleted user's access to a project is
removed automatically due to expiration, the audit event is created for "Deleted User". We are [investigating ](https://gitlab.com/gitlab-org/gitlab/-/issues/343933 )
whether this is avoidable.
2019-05-05 15:21:25 +00:00
### Missing events
2021-11-04 06:09:57 +00:00
Some events are not tracked in audit events. See the following
2020-02-20 18:08:51 +00:00
epics for more detail on which events are not being tracked, and our progress
2019-05-05 15:21:25 +00:00
on adding these events into GitLab:
- [Project settings and activity ](https://gitlab.com/groups/gitlab-org/-/epics/474 )
- [Group settings and activity ](https://gitlab.com/groups/gitlab-org/-/epics/475 )
- [Instance-level settings and activity ](https://gitlab.com/groups/gitlab-org/-/epics/476 )
2021-11-04 06:09:57 +00:00
Don't see the event you want in any of the epics linked above? You can either:
- Use the **Audit Event Proposal** issue template to
[create an issue ](https://gitlab.com/gitlab-org/gitlab/-/issues/new?issuable_template=Audit%20Event%20Proposal ) to
request it.
- [Add it yourself ](../development/audit_event_guide/ ).
2021-04-30 00:10:28 +00:00
2022-04-27 15:10:01 +00:00
### Removed events
2019-09-23 18:06:14 +00:00
2022-04-27 15:10:01 +00:00
> - Repositories push events was [deprecated](https://gitlab.com/gitlab-org/gitlab/-/issues/337993) in GitLab 14.3.
> - Repositories push events was [removed](https://gitlab.com/gitlab-org/gitlab/-/issues/337993) in GitLab 15.0.
2019-09-23 18:06:14 +00:00
2022-04-27 15:10:01 +00:00
The repositories push events feature was:
2022-02-07 00:15:28 +00:00
2022-04-27 15:10:01 +00:00
- [Deprecated ](https://gitlab.com/gitlab-org/gitlab/-/issues/337993 ) in GitLab 14.3.
2022-04-28 00:08:57 +00:00
- [Removed ](https://gitlab.com/gitlab-org/gitlab/-/issues/337993 ) in GitLab 15.0.
2020-09-18 00:09:39 +00:00
2020-11-24 18:09:14 +00:00
## Search
The search filters you can see depends on which audit level you are at.
| Filter | Available options |
| ------ | ----------------- |
| Scope (Project level) | A specific user who performed the action. |
| Scope (Group level) | A specific user (in a group) who performed the action. |
| Scope (Instance level) | A specific group, project, or user that the action was scoped to. |
| Date range | Either via the date range buttons or pickers (maximum range of 31 days). Default is from the first day of the month to today's date. |
2021-10-22 03:11:57 +00:00
![audit events ](img/audit_events_v14_5.png )
2020-11-24 18:09:14 +00:00
2021-01-28 12:09:54 +00:00
## Export to CSV **(PREMIUM SELF)**
2020-09-18 00:09:39 +00:00
2021-09-07 15:11:06 +00:00
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/1449) in GitLab 13.4.
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/285441) in GitLab 13.7.
2020-09-18 00:09:39 +00:00
2020-12-14 06:09:41 +00:00
Export to CSV allows customers to export the current filter view of your audit events as a
2020-11-24 18:09:14 +00:00
CSV file, which stores tabular data in plain text. The data provides a comprehensive view with respect to
2020-09-18 00:09:39 +00:00
audit events.
2021-11-04 06:09:57 +00:00
To export the audit events to CSV:
2020-09-18 00:09:39 +00:00
2021-08-26 00:09:31 +00:00
1. On the top bar, select **Menu > Admin** .
2021-06-15 18:09:57 +00:00
1. On the left sidebar, select **Monitoring > Audit Events** .
2020-11-24 18:09:14 +00:00
1. Select the available search [filters ](#search ).
2021-06-15 18:09:57 +00:00
1. Select **Export as CSV** .
2020-09-18 00:09:39 +00:00
### Sort
2020-11-24 18:09:14 +00:00
Exported events are always sorted by `created_at` in ascending order.
2020-09-18 00:09:39 +00:00
### Format
Data is encoded with a comma as the column delimiter, with `"` used to quote fields if needed, and newlines to separate rows.
The first row contains the headers, which are listed in the following table along with a description of the values:
| Column | Description |
|---------|-------------|
| ID | Audit event `id` |
| Author ID | ID of the author |
| Author Name | Full name of the author |
| Entity ID | ID of the scope |
2020-11-24 18:09:14 +00:00
| Entity Type | Type of the scope (`Project`/`Group`/`User`) |
| Entity Path | Path of the scope |
2020-09-18 00:09:39 +00:00
| Target ID | ID of the target |
| Target Type | Type of the target |
| Target Details | Details of the target |
| Action | Description of the action |
| IP Address | IP address of the author who performed the action |
| Created At (UTC) | Formatted as `YYYY-MM-DD HH:MM:SS` |
### Limitation
2021-11-04 06:09:57 +00:00
The audit events CSV file is limited to a maximum of `100,000` events.
2020-09-18 00:09:39 +00:00
The remaining records are truncated when this limit is reached.