How to Request Audit Logs?

Overview

CircleCI Cloud Customers can retrieve audit logs by using the Self-serve audit log feature via the CircleCI UI. 

Self-serve Audit logs

To retrieve audit logs please navigate to your organization settings page > "Security"  and scroll down to the "Audit logs" section. The user requesting audit logs is required to be an organization admin. If you are not an organization admin, you will not see this feature. 

Additionally, self-serve audit log retrieval is limited by the following per plan type: 

• Paid plans - 3 requests per day

• Free - 1 request per day

Note: Requests are limited to a 30-day window.

For more information on self-serve audit logs, please refer to our documentation:

• Request audit logs from the web app

Unsupported Audit Logs

CircleCI does not support the following:

• Recurring audit logs (Scale Plan customers see below)
• Project-level audit logs

Scale Plan: Stream Audit Logs

Stream audit logs allow you to set up audit log streaming direct to your own AWS S3 bucket.

Audit log streaming provides the following benefits to your organization:

• Maintain comprehensive security visibility.
• Meet compliance requirements.
• Integrate CircleCI audit data with your existing security monitoring infrastructure.

See more details in our docs here: Stream audit logs

Considerations

Please reach out to Support if you run into trouble accessing your Security settings.