The Audit Trail allows you to view user and system activity, filter activity for specific actions or actors, and export your data to an event streams source or CSV file.
Viewing the Audit Trail requires Workspace Owner permissions
You must have the Workspace Owner role to view the Audit Trail page. For more information about roles and permissions within Segment, see the Roles documentation.
To view the Audit Trail:
- From the Segment app, select Settings.
- From the Settings tab, select Admin.
Audit Trail events
The Audit Trail returns information about the following Segment product areas:
- Consent Management
- Tracking Plans
- Destination Filters
- Computed Traits
- Engage Warehouse Sources
- Profiles Sync
To view a list of all events Segment surfaces in the Audit Trail, open the Audit Trail, click Filters, and select the Events dropdown.
Use the Filters dropdown to refine your search results and filter by actions or actors to see who made changes on specific resources in the app. Actors include both logged-in users and access tokens.
You can forward events in your workspace to an event streams source to set up real-time alerts and quickly revert changes (like a user unintentionally disabling a warehouse) that could cause unwanted downstream effects.
Segment recommends creating a dedicated source for Audit Trail events
Segment recommends forwarding all events to an instance of the HTTP API source. Segment passes all forwarded events through its entire processing pipeline. This ensures that Tracking Plans, Filters, and other features work with the audit events, and also ensures you can send those events to multiple downstream destinations.
To forward Audit Trail events to an event streams source:
- Navigate to Settings > Workspace Settings > Audit Forwarding.
- Select or create an event streams source to which you’ll forward workspace events.
- Toggle the setting to On and click Save Changes.
When you forward audit events to a source, Segment passes those events through its entire processing pipeline. This ensures that tracking plans, filters, and other features work with the audit events, and also ensures you can send those events to multiple downstream destinations.
Frequently asked questions
Why am I getting alerts about an audience/computed trait sync failure, but when I look at the specific audience/computed trait it shows a successful sync?
An audience/computed trait Run or a Sync may fail on its first attempt, but Engage will retry up to 5 times before considering it a hard failure and display on that audience/compute trait’s Overview page. As long as the runs/syncs within the specific Audience’s Overview page say they are successful, then these can be safely ignored.
How things work internally: Segment Engage scheduler fetches audiences/traits from compute service and then handles the logic of generating tasks. These compute/sync tasks get scheduled and executed by another worker. Essentially, these tasks are a list of steps to be executed. Each task has a series of steps that are marked as complete by saving a timestamp for the completion. If the worker is disrupted, it picks up at the latest step, which has no completed_at timestamp. In some cases, the step may fail or the entire task may fail (for example, due to timeout or the worker disruption as there are many moving parts). In either case, these failures will be retried.
These tasks are a part of internal Segment process, and there are systems in place to retry failed tasks. In most cases, it is not necessary to track these failures, as long as there are no actual computation or sync failures.
The Audit Trail logic, however, is configured to notify you about every task failure, even if it then later succeeds.
If you would like to avoid receiving the notifications for transient failures, reach out to support, to request enabling a setting to reduce the number of notifications your workspace receives.
This page was last modified: 21 Feb 2024
Questions? Problems? Need more info? Contact Segment Support for assistance!