Execution Details
A row in the Overview table is a record, and three controls on it lead to more detail: Trace opens the workflow execution behind the record, View drills down to the records beneath it at the next view level, and the row's expander opens the Timeline View of every event that touched it. Together they answer why a record is in the state it is in.
Before you begin
- Open the application, choose the Integration and View, and find the record. See Application details.
- The record must be within the trace retention period of its environment to open a trace. Development traces are kept for 7 days and production traces for 90.
The Trace column
Each row's Trace column holds two controls. Hovering the column header explains them: Trace: view trace logs | View: drilldown into record details.
| Control | When it is enabled | Tooltip |
|---|---|---|
| Trace | A trace was captured for the execution and is inside retention | Click to view trace |
| View | The record has records beneath it at the next view level | Click to view drilldown details |
When a trace has aged out, the Trace tooltip instead names the environment and its retention period. When a record has nothing beneath it, the View tooltip reads No drilldown available for this record.
Open the workflow trace
- Select Trace on the row.
The Workflow Trace drawer opens with the workflow's activities in execution order, each with its timing, and a details panel for the selected activity. The details panel carries the activity's payload; for a fallout the payload is read-only and labelled Fallout Payload. View only — use edit to modify before retry. Selecting Trace on a row whose trace is already open reports This Trace is already open.
Read the trace the same way as in Studio's metrics: find the first activity that did not complete, and read its payload. The same execution can be opened from Studio's metrics dashboard when the trace has aged out of Engage but not out of Studio.
Drill down a level
Views are layered, and the key columns configured on each view are what connect a record at one level to its records at the next. See Configure views.
- Select View on the row.
The table replaces itself with the records at the next level that share the row's key values, and a Back control appears above it. While you are drilled down, the View selector in the tab bar is disabled; select Back to return to the level you came from and re-enable it.
A drilled-down table has the same Search, query, export, and fullscreen controls as the top level, scoped to the records shown.
Read the timeline
Every row has an expander at its left; its tooltip reads Timeline View.
- Select the expander.
The Timeline View drawer opens with every event that touched the record, in order, each with its status tag and event name. Expand All and Collapse All open or close every event's details at once. A record with no events reads No Records Found.
The timeline is the quickest way to see the update-in-place pattern at work: a record reported first as pending and later as successful shows both events here even though the table shows only the final status.
When it does not work
| Symptom | Cause | What to do |
|---|---|---|
| Trace is disabled and the tooltip names a retention period | The execution is older than the environment allows | Look the execution up in Studio's metrics instead |
| View is disabled with No drilldown available for this record | No lower-level view has records sharing this record's key values | Check the lower view's key columns; if the keys are right, the workflow never reported the lower-level events |
| This Trace is already open | The trace drawer for this execution is already showing | Use the open drawer |
| Failed to load child view. | Engage could not fetch the lower level | Select Back and try again |
Next steps
If the trace shows a failed step, the execution is probably also a fallout. Find it under the application's Fallouts tab or in Global Fallout, where it can be retried.