Audit Trail

The Tetra Data Platform (TDP) has a secure, computer-generated, time-stamped audit trail to independently record the date and time of operator entries and actions that create, modify, or logically delete electronic records. As an Admin user, you can access the audit trail, filter and view audit trail records, and download them to a CSV for further analysis or record keeping. The audit trail was designed and validated for compliance with 21 CFR Part 11. Audit trail records can be accessed but they cannot be altered, and are retained indefinitely.

Access the Audit Trail Page

To access the page as an Admin user, do the following:

1. In the Tetra Data Platform, click the Hamburger icon at the top left corner of the page to expand the TDP menu options (or hover over the list of icons to display the menu options):

2. From the Tetra Data Platform, click Administration from the left side of the page.
3. Click Audit Trail to open the Audit Trail page. The audit log records display listing the most recent records at the top of the page.

📘

Possible Time Lag

There may be a possible time lag of up to five minutes for actions to display in the Audit Trail page.

View and Filter Audit Trail Records

To view and filter audit trail records, you can select various options at the top of the page. To view all of the audit trail records, leave all filter fields blank.

Audit Trail Filters

Entities and Logged Actions

View Audit Trail Results

After you select filters to view the audit trail records, information matching those filters displays on the page. To review the next page of results, click the page number or arrow keys at the bottom right corner of the page.

Audit Trail Result Fields

Export Audit Trail History

To export your audit trail history to a CSV file:

1. You can click one or more checkboxes from the Audit Trail page for the audit logs you want to export. To select and export all retrieved records, click the checkbox next to the ENTITY column label. The Export All Data to CSV button label changes to indicate the number of records selected. For example, if you chose 3 records, the button label will read "Export 3 Selections to CSV."

2. After you have selected one or more checkboxes, the Export xxx Selections to CSV button displays. Click the button to start the download process for the selected entities.
3. The CSV file is downloaded and ready to use. The CSV file provides additional information not shown in the audit trail results list:

• id - Unique identifier of the specific entities in the log files.
• org_slug - Organizational slug of the actor
• actor_id - Unique identifier for the actors
• actor_type - Indicates the type of actor
• actor_name - Name of the actor
• actor_email - Email address of the actor
• ip_address - Actor's IP address
• host - Name of the host
• auth_token_ending - Last seven characters of the authorization token
• entity_name - Name of entity
• entity_type - Type of entity
• entity_id - ID for the entity
• action - Action performed on the entity
• before - Entity details before the action was taken. Typically, for create or login-attempt actions, this field remains empty. For update or delete actions, the field shows the state of the entity before the action occurred.
• after - Entity details after the action was taken. For delete actions, this field typically is empty.
• entity-schema-version - Schema version for the entity (if the entity has one)
• created_at - Date/timestamp for the log entry

📘

Log Retention

There is no purge policy for entries in the Audit Trail.

📘

Disabling the Audit Trail

You should disable the audit trail for development environments only. If you disable the audit trail for production environments, you will not be able to demonstrate compliance with GxP quality guidelines and regulations.

📘

AWS and Auditing Information

• Tetra Agent audit information displays in AWS CloudWatch.
• AWS Infrastructure logs that contain automated and user-initiated data is captured in AWS CloudWatch and CloudTrail. For details about these features, click these AWS documentation links: CloudWatch and CloudTrail.

View Historical Audit Trail Data From Previous TDP Versions

To view the audit trail data for historical audit trail data prior to upgrade to version 3.0 (March 31, 2021) of the TDP, do the following:

1. Click the Historical Audit Data link in the upper right corner of the Audit Trail page. The Historical Audit Data page displays.

2. You can adjust these filters to view the logs by doing the following:

• From date/time - Display log entries starting with this date and time.
• To date/time - Display log entries through this date and time.
• Apply Date/Time Filters - Click to apply the date/time filters.
• Entity - Select the entity to view.

3. To adjust the number of logs shown per page, you can select a number in the Logs per Page dropdown at the bottom of the page. You can also select to view a range of logs from 20 to all log entries.
4. To export your results as a CSV file, click Export as CSV near the top right corner of the page. You can specify these fields to export by doing the following:

• From date - Enter from the date, or click the calendar to select the date
• From time - Enter from the time, or click the clock to select the time.
• To date - Enter from the date, or click the calendar to select the date
• To time - Enter from the time, or click the clock to select the time.
• Entity - Select all or a specific entity to export.

5. Click Export.
6. To return to the current Audit Trail page, click the Current Audit Data link at the top left of the page.