Audit Trail

The audit trail provides a tamper-evident, chronological record of every significant action performed in the system. It captures who did what, when, and to which resource — meeting regulatory requirements for 21 CFR Part 11, EU GMP Annex 11, and other compliance frameworks.

Accessing the Audit Trail

Navigate to Admin from the sidebar.
Select the Audit Trail tab within the administration panel.

Filtering Audit Logs

The filter panel at the top of the audit trail page provides several criteria to narrow down results:

Filter	Description
Search	Free-text search across audit entries
User	Filter by a specific user (searchable user selector)
Resource Type	Filter by type: Document, Deviation, Training Record, Audit Log, CAPA, or User
Action	Filter by action: Create, Update, Delete, View, List, or Approve
Date From	Start date for the time range
Date To	End date for the time range
Limit	Number of entries to display: 50, 100, 200, or 500

Filters are applied automatically as you change them. All filters can be combined to create precise queries.

Understanding the Audit Log Table

Each audit log entry displays the following columns:

Column	Description
Timestamp	Date and time the action occurred
User	Email address or user ID of the person who performed the action
Action	The type of action (create, update, delete, view, list, approve)
Resource Type	The type of resource affected
Resource ID	The identifier of the specific resource
Details	Additional context or reason for the action
Verified	Integrity verification status (checkmark or cross)

Sorting

Click any column header to sort the table by that column. Click again to toggle between ascending and descending order. An arrow indicator shows the current sort direction.

Integrity Verification

Each audit log entry includes an integrity verification flag. This indicates whether the entry has been validated against tampering. A checkmark means the entry has passed integrity checks; a cross indicates it has not been verified or verification failed.

Exporting Audit Logs

The audit trail supports three export formats, accessible via buttons above the log table:

CSV Export

Exports the current filtered results as a comma-separated values file
Includes columns: ID, User, Action, Resource Type, Resource ID, Reason, Location, Created At, Integrity Verified
Maximum of 200 records per export
Shows a progress bar during export

PDF Export

Generates a formatted PDF report from the server
Applies the current filter criteria
Downloads as audit_report.pdf

Excel Export

Generates an Excel spreadsheet (.xlsx) from the server
Applies the current filter criteria
Downloads as audit_logs.xlsx

Audit Summary Widgets

Above the log table, summary widgets provide at-a-glance metrics about audit activity. These widgets aggregate key statistics to help you quickly assess the overall state of system activity.

Audit Findings

If there are open audit findings in the system, an alert banner appears at the top of the audit trail page indicating how many findings require attention.

The Audit Findings Resolution section at the bottom of the page allows authorized users to:

View all open findings
Update finding statuses (e.g., mark as resolved)

Embedded Audit Trail

Individual resource pages (such as document detail views) include an embedded audit trail showing only the history for that specific resource. This embedded view displays:

When — Timestamp of the action
User — Who performed it
Action — What was done
Meta — Additional location or context metadata

This provides quick access to a resource’s history without needing to navigate to the full admin audit trail.

Permissions

Role / Permission	Access Level
Admin	Full audit trail access
QA Team	Full audit trail access
`audit.view_trails`	View audit logs
`audit.view`	View audit logs