--- title: "Viewing, Filtering, and Downloading Audit Logs" slug: "viewing-filtering-and-downloading-audit-logs" tags: ["Audit log", "view", "Download"] updated: 2025-12-15T16:38:43Z published: 2025-12-15T16:38:43Z canonical: "docs.revealdata.com/viewing-filtering-and-downloading-audit-logs" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Viewing, Filtering, and Downloading Audit Logs ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/viewing-filtering-and-downloading-audit-logs-image-07nvbn3l.png) #### In this article you will learn how to: - View Audit Logs - Understand Audit Log Filters - Download Audit Logs ## **What are Audit Logs?** Audit logs give Onna Admins the ability to understand user activity inside the platform. Specifically, audit logs will show users’ actions such as adding/deleting sources, syncing errors, viewing documents, and sharing. Audit logs provide an added level of security to your platform by offering visibility into user actions. ## **Viewing Audit Logs** To access Onna audit logs follow the steps below: ### Step 1 To begin, select **“Audit Logs”** from the navigation menu inside the Admin Console. ![Workspaces-00.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-00.png) ### Step 2 From here you will be taken to the Audit Logs main page where you will see a list of logs. The list will be sorted by date, beginning with the most recent. However, each column can be sorted in ascending or descending order. Additionally, you can filter your audit logs for a customized view by clicking in one of two places: 1. **“+Add filter”** above your audit logs 2. The **“Filter” icon** in the upper right corner of your screen ![Workspaces-01.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-01(1).png) ## **Understanding Audit Log Filters** You are able to filter logs by: - Action - Category - Code - Date - IP Address - Time - Type - User To learn more about each filter descriptions check below. ## Filter Descriptions ### Action The Action filter will display the log for any action performed by a user within your Onna site. The actions shown include: - Access - Add - Delete - Edit - Manage - Rename - Share - Sync - Update - View ![Workspaces-02.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-02.png) ### Category The category filter indicates what/where an action was taken related to the following categories: - Custom field - File - Info - Login - Retention policy - Source - Workspace ![Workspaces-03.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-03.png) ### Code The code filter will display the log for specific audit log codes. For a comprehensive definition of audit codes please visit Audit Log Code Definitions. ![Workspaces-04.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-04.png) ### Date The date filter will display a date range. To manually set a date range click **“Custom”** and a calendar will pop up. Otherwise you can view logs from the follow date ranges: - Today - Yesterday - Last 7 days - Last 30 days - Last 60 days ![Workspaces-05.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-05.png) ### IP Address The IP Address filter will display logs associated with a user’s IP Address. You can manually enter a user’s IP Address or select IP Address’ from a dropdown. ![Workspaces-06.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-06.png) ### Time The time filter will display logs for a specified time range. Please note that in order to filter by time you must filter by date first. ![Workspaces-07.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-07.png) ### Type The Types filter will display logs related to the following types: - Error - Info - Success ![Workspaces-08.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-08.png) ### User The user filter will display logs related to specific users. A user name can be manually entered or selected from a dropdown list. ![Workspaces-09.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-09.png) ## **Downloading Audit Logs** It is possible to export audit logs for reporting and security purposes. Audit logs will download as CSV files and will include the following information: code, date, user, IP Address, Type, Category, Action, and Message. To understand more about each export field, see Understanding Audit Log Filters. To export audit logs, follow the steps below: ### Step 1 To begin downloading audit logs, go to the Audit Log page of the admin console. ![Workspaces-10.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-10.png) ### Step 2 Next, you’ll filter the audit logs by date and will set the date range for your download. ![Workspaces-11.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-11.png) ### Step 3 After you’ve set the date for the logs you want to export, you will click on the ‘Download’ icon in the upper right corner of your screen. ![Workspaces-12.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-12.png) ### Step 4 After clicking the ‘Download’ icon you’ll see that your logs have been downloaded as a .csv file. ![Workspaces-13.png](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/Workspaces-13.png) ## **FAQ** ### How long are audit logs available? Application audit logs are retained indefinitely.