Skip to main content

Viewing, Filtering, and Downloading Audit Logs

  • Updated

Account_Holder_Admin_Member_with_special_permissions.png

In this article you will learn how to: 

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. 

 

Viewing_Audit_Logs_Step_1.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

 

 

Viewing_Audit_Logs_Step_2.jpg

Return to top of page

 

Understanding Audit Log Filters 

You are able to filter logs by: 

To learn more about each filter, see descriptions below: 

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
  • Create
  • Delete
  • Enable
  • Manage
  • Share
  • Sync
  • Update
  • View
 Audit_Logs_Action_Filter.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

Audit_Log_Category_Filter.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

 

Audit_Log_Code_Filter.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
 Audit_Log_Date_Filter.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. 

 

Audit_Log_IP_Address_Filter.jpg

 

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. 

 

Audit_Log_Time_Filter.png

 

Type

The Types filter will display logs related to the following types: 

  • Error
  • Info
  • Success

 

Audit_Log_Type_Filter.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.

 

Audit_Log_User_Filter.png

Return to top of page

 

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. 


Step1_download_audit_logs.jpg

Step 2

Next, you’ll filter the audit logs by date and will set the date range for your download. 

 

Step2_download_audit_logs.jpg

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. 

 

Step3_download_audit_logs.jpg

Step 4

After clicking the ‘Download’ icon you’ll see that your logs have been downloaded as a CSV file. 

 

Step4_download_audit_logs.jpg

Return to top of page

 

 

Related articles