--- title: "Managing audit files" slug: "oa-ag-managing-audit-files-3-29" updated: 2026-10-07T08:39:42Z published: 2026-10-07T08:39:42Z canonical: "docs.onespan.com/oa-ag-managing-audit-files-3-29" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Managing audit files Individual audit records can be viewed in the live audit viewer, and filtered and exported using the OneSpan Authentication Server Appliance Configuration Tool. Events generated by the OneSpan Authentication Server component for auditing are stored in the internal database. They are moved to an audit database on a monthly basis or until a maximum audit data size limit of 500 MB is reached. When this limit is exceeded, new audit data is stored in a new database part. Parts of the database can be downloaded and deleted via the OneSpan Authentication Server Appliance Configuration Tool. Downloading is the same as the exporting, but uses a format compatible with OneSpan Authentication Server. ![Live Audit Viewer](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OA.Live_audit_export.png?sv=2026-02-06&spr=https&st=2026-11-16T16%3A27%3A21Z&se=2026-11-16T17%3A27%3A21Z&sr=b&sp=r&sig=FleHk89hDCMchnaQwGRdIz5V%2FPLaz0%2BeaK%2FGkvyZiF8%3D) Figure: Live Audit Viewer ## Viewing audit files To view and filter audit files 1. Sign in to the [OneSpan Authentication Server Appliance Configuration Tool](/sec/docs/oa-ag-accessing-configuration-tool-and-administration-web-interface-3-29). 2. Navigate to Monitoring > Audit Logs. 3. If required, you can filter by using simple or advanced filters:. - To use the simple filter, type the characters to be searched for in the message part of the audit message in the Filter box. Only lines with content that matches the filter entry will be listed. To clear the filter, click X. - To use the advanced filter, click the arrow to the right of the Filter box to open the Advanced Filter dialog (see [Figure: Advanced audit filter fields](/sec/docs/oa-ag-managing-audit-files-3-29#Fig_AdvancedAuditFilterFields)). For more information about searching using the filter fields, see [Table: Audit filter fields](/sec/docs/oa-ag-managing-audit-files-3-29#Tab_AuditFilterFields). ![Using the advanced filter](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OA.Advanced_filter.png?sv=2026-02-06&spr=https&st=2026-11-16T16%3A27%3A21Z&se=2026-11-16T17%3A27%3A21Z&sr=b&sp=r&sig=uT%2ByNPWm3fZFOclckUK%2FcmQb9Pq%2BrM%2B6v%2FKWzP9vg2o%3D) Figure: Using the advanced filter ![](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OA.Audit_Advanced_Filter.png?sv=2026-02-06&spr=https&st=2026-11-16T16%3A27%3A21Z&se=2026-11-16T17%3A27%3A21Z&sr=b&sp=r&sig=SVvAgEDoj7rzTWSDCYB6eOXh1qgLD1A2QkTkgtIU1rE%3D) Figure: Advanced audit filter fields | Type | Description | | --- | --- | | Start Date | Only records after the date specified are displayed. | | End Date | Records up to and including the entered date are displayed. | | Type is | Only audit messages of the selected type are displayed (see [Send Audit Messages to Syslog](/sec/docs/oa-ag-audit-settings-3-29#send-audit-messages-to-syslog)). | | Source contains | This field is only relevant if you have a replication setup (see [Configuring replication](/sec/docs/oa-ag-configuring-replication-3-29)). Only records generated from this server are displayed. | | Category contains | Only records with a category matching the category entered in this field are displayed. | | Code contains | Only records with a matching error code are displayed. For a list of possible error codes, see [Error codes](/sec/docs/oas-aref-error-messages-3-29). | | Host contains | Only records with a matching IP address are displayed. | | Hostname contains | Only records with a matching host name are displayed. | | Description contains | Only records with a matching string in the Description field are displayed. | | Field ... contains | Select a field in the drop-down list and enter the matching string to be searched for. Only matching records are displayed. | It is only possible to access the advanced filter when the simple filter is cleared. To clear the simple filter, click the X icon next to the Filter box. ## Exporting and downloading auditing information Exporting auditing information can be useful in the following cases: - One reporting system is used for all servers on a network. - Auditing information needs to be kept for a long time. You can use filters to define which data should be exported. To export audit files 1. Sign in to the [OneSpan Authentication Server Appliance Configuration Tool](/sec/docs/oa-ag-accessing-configuration-tool-and-administration-web-interface-3-29). 2. Navigate to Monitoring > Audit Logs. 3. Click Export. The Export Log dialog opens (see [Figure: Exporting audit files](/sec/docs/oa-ag-managing-audit-files-3-29#Fig_ExportingAuditFiles)). Fields are explained in [Table: Audit export fields](/sec/docs/oa-ag-managing-audit-files-3-29#Tab_AuditExportFields). ![Exporting audit files](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OA.Export_Log.png?sv=2026-02-06&spr=https&st=2026-11-16T16%3A27%3A21Z&se=2026-11-16T17%3A27%3A21Z&sr=b&sp=r&sig=AVgQylQoEpSOr6E6YB1Ie6iAFbTqPvhNigv1elrfYBY%3D) Figure: Exporting audit files | Type | Description | | --- | --- | | Start date | Only records after the date specified are exported. | | End date | Records up to and including the entered date are exported. | | Source | This field is only relevant if you have a replication setup (see [Configuring replication](/sec/docs/oa-ag-configuring-replication-3-29)). Only records generated from this server are exported. | | Category | Only records with a category matching the category entered in this field are exported. | | Host | Audit records can be exported for all servers, or the local host only. | | Output Format | This is the data output format to use: - IDENTIKEY. Select this option for OneSpan Authentication Server compatibility. It allows you to import the exported data to an instance of OneSpan Authentication Server that is acting as a dedicated reporting server in a setup with multiple OneSpan Authentication Server and/or OneSpan Authentication Server Appliance instances. - CSV. The comma-separated values format allows the data to be imported by other auditing systems. Note that the CSV option creates an export file that uses tab characters as the separator. | To download audit files 1. Sign in to the [OneSpan Authentication Server Appliance Configuration Tool](/sec/docs/oa-ag-accessing-configuration-tool-and-administration-web-interface-3-29). 2. Navigate to Monitoring > Log File Management and click Databases. Available audit files will be listed below. 3. Click the download icon to the right of an available audit file to download it. ![Downloading audit files](https://cdn.document360.io/038f59a7-abd0-4c14-9de7-3434d28b49fd/Images/Documentation/OA.Log_File_Mgmt.DB_download.png?sv=2026-02-06&spr=https&st=2026-11-16T16%3A27%3A21Z&se=2026-11-16T17%3A27%3A21Z&sr=b&sp=r&sig=R4Y1acIUseyCYmbBog%2FuJjGAgictS5z3YmrvKj0DQ5I%3D) Figure: Downloading audit files > Downloading audit data is the same as exporting and uses the OneSpan Authentication Server–compatible format. > > It is not possible to remove database partitions manually. However, you can set up log files to be deleted automatically. To configure automatic deletion of audit files 1. Sign in to the [OneSpan Authentication Server Appliance Configuration Tool](/sec/docs/oa-ag-accessing-configuration-tool-and-administration-web-interface-3-29). 2. Navigate to Settings > Logging and Auditing. 3. Select Delete audit logs and specify how long you want to keep audit logs.