> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/administration/audit-logs/amazon-s3",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Using Amazon S3 for Omni audit logs

> Track Omni user activity in your instance with structured logs, accessible in an Amazon S3 bucket.

<Note>
  Reach out to Omni support to have audit logs enabled for your instance.
</Note>

Audit logs are detailed records of the activity your users are taking in Omni, which can be useful for security and performance analysis. Events included in logs are structured as JSON payloads and sent in batches to your cloud storage bucket a few minutes after they're written.

## Requirements

To follow the steps in this guide, you'll need:

* To have audit logs enabled in your Omni instance
* Permissions in AWS that allow you to manage IAM roles

## Setup

After audit logs are enabled in your instance, complete the following:

<Steps>
  <Step title="Provide Omni support with your AWS IAM role">
    Reach out to Omni support with the name of the AWS IAM role you want to use.
  </Step>

  <Step title="Complete setup with Omni support">
    Omni support completes the configuration on the Omni side.
  </Step>
</Steps>

## Next steps

* Learn about the [event types](/administration/audit-logs/event-types) supported for audit logs
* Check out your instance's [Analytics section](/administration/analytics)