Trace is a testing and inspection tool for your EventStream and AudienceStream configuration that allows you to capture your workflow as a visitor and watch how events and customer data are processed in real-time.
This article describes how to start and stop a new trace, join an active trace, and view the overview panel and trace log.
In this article:
The following items are required to use Trace:
Trace provides an inside view into the inner workings of EventStream and AudienceStream. The trace tool is critical for testing your configuration. You can use trace to observe the details of a predefined workflow, ensure that attributes update correctly, rules are correctly applied, and that actions trigger as expected.
From the Trace interface, you can:
After you have saved your Customer Data Hub configuration and are ready to begin testing your enrichments, audiences, and actions, you need to get a Trace ID to use in the Trace tool.
Use the following steps to get a Trace ID:
Use the following steps to start a trace:
If you have closed the trace screen, click Server-Side > Trace and the screen slides out again. You can use the trace screen to start or join a trace without leaving your current location in the product. When a trace is in progress, a blue arrow next to Server-Side > Trace pulses.
From the trace screen, you can replay, pause, or resume an event by clicking one of the icons in the trace summary.
The following table provides details on each of the trace icons.
|Play at normal speed. The default setting used to replay an event is normal speed.|
|Play at twice the normal speed.|
|Pause the ongoing trace. When paused, trace continues to process new events behind the scenes but does not display new log entries until you click pause again to restart.|
|View the latest visitor profile. Displays a snapshot of the profile for the latest visitor in JSON format. Click OK to exit this window.|
|Get code to replay events generates a curl command for each event. You can run the curl commands in a terminal window to replay an event in trace without having to recreate the configuration steps on the web page.
|Exit the current trace. If the trace is still active on the web page, you can rejoin the trace using the Trace ID.|
The following image shows the parts of the trace interface. The Trace Log is a real-time scrolling summary of actions, events, and audiences. The Overview Panel displays a snapshot of the detailed activity. Search can be used to find specific attributes in the list of visitor and visitor-scoped attributes. The attributes in the list are grouped by data type (Numbers, Dates, and so on). Filters can be used to filter these attributes.
Filtering allows you to determine if the attributes and the configurations tied to them are functioning properly. Using filters, you can choose how to view the attributes and their values. You can filter attributes by Label (if you have added labels for attributes) or by Type, where Type is one of the following
In the trace log, clickable text is blue, other text is gray. The timestamp adjacent to the log entry displays the time of the log entry. To view the details of an event, click the blue event text to slide out a detailed view of the event.
You can minimize the trace window to continue the process while moving on to other feature of the UI.
Use the following steps to end an active trace and associated visitor session.
Use the following steps to join a trace that is currently in progress:
You must exit any active traces before you can join a trace.