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

# Audit

> This section provides the purpose, elements, and actions performed on the Audit pages.

This section provides the purpose, elements, and actions performed on the
**Audit** pages.

## Purpose

The **Audit** page helps you monitor user activity on your Aviatrix Platform.
Use it to review common user actions and results. The page displays information
from the Aviatrix Controller Command Logs; the actions listed are Controller API
calls. Time controls, summary charts (Top 5 Actions, Top 5 Users, Actions by
Time), and the audit log table let you filter and export the data.

## Elements

<Frame>
  <img src={"/images/reference/ui/administration/audit.png"} alt="Audit: Audit" width="100%" />
</Frame>

* **Time Period**: Dropdown to select time period (Last 60 Minutes, Last 24
  Hours, etc.).
* **Start**: Date/time picker for start time.
* **End**: Date/time picker for end time.
* **Filter**: Filter button to show/hide filter options.
* **Apply**: Apply button to apply time period and filter settings.
* **Top 5 Actions**: Chart displaying top 5 actions with counts.
* **Top 5 Users**: Chart displaying top 5 users (may show "No data found").
* **Actions by Time**: Chart displaying actions over time.
* **Show filters**: Button to show filters for the audit log table.
* **Select columns**: Button to select columns for the audit log table.
* **Export**: Export button to download audit data.
* **Raw Logs**: Raw Logs button to view raw audit logs.
* **Search**: Search box for filtering table content.

## Actions

<AccordionGroup>
  <Accordion title="View Audit Logs">
    To view audit logs:

    1. Go to **Administration** > **Audit**.
    2. The page appears with time controls (**Time Period**, **Start**, **End**), summary charts (Top 5 Actions, Top 5 Users, Actions by Time), and the audit log table.
    3. Optionally, set **Time Period** or **Start**/**End**, click **Apply**, use **Show filters**, **Select columns**, **Export**, **Raw Logs**, or **Search**.

    The audit log table shows timestamp, action, user, result, reason, and
    key-values for the selected time range.

    ### Parameter Details

    | CoPilot Parameter Name | Description                                                                                          |
    | ---------------------- | ---------------------------------------------------------------------------------------------------- |
    | Timestamp              | Shows the date and time when the audit event occurred.                                               |
    | Action                 | Shows the type of action that was performed (e.g., USER\_LOGIN\_MANAGEMENT, MANAGE\_SAML\_ENDPOINT). |
    | User                   | Shows the user who performed the action.                                                             |
    | Result                 | Shows the result of the action (e.g., Success, Failure).                                             |
    | Reason                 | Shows the reason for the action result if applicable.                                                |
    | Key-Values             | Shows key-value pairs associated with the audit event.                                               |
  </Accordion>
</AccordionGroup>
