Skip to main content

Working with the Trace

Each trace screen consists of several elements.

Layout of the trace screen:

  • Top bar
  • View switcher: Graph / Waterfall / Tree
  • Side panels group: Deps / Tool I/O / Details.
  • Visualization area
  • Right-hand panels

Steps:

  1. Read the summary in the top bar to size up the run (node count, number of LLM calls, total tokens).
  2. Pick a view that fits your goal:
    • Graph
    • Waterfall
    • Tree

Graph View

A node graph of the run, with arrows connecting steps. It includes collapsible groups, guardrail badges, nested-step counters, and a final-result card.

User can perform several actions:

  1. Zoom In / Out — click the + / − buttons, or hold the mouse over the graph and scroll the wheel for smooth zoom.
  2. Fit View — click Fit View to fit the whole graph into the visible area.
  3. Pan — click and drag empty canvas to move around.
  4. Mini Map — click a region of the mini map to jump there.
  5. Toggle Interactivity (lock icon) — lock/unlock the canvas to prevent or allow moving node positions.

Waterfall View

What it shows: A time diagram of spans. Each row is a span with its name, type, duration and sometimes tokens. Groups are collapsible. Controls include Critical path, Reset zoom, a zoom-window slider, and hints "⇧ drag to zoom · ⌘ wheel".

Tree View

A hierarchical Trace tree. Each node has a type icon, a name, an iteration label a duration, tokens (for LLM nodes) and tool-call counters. Branches are expandable.

User can perform several actions

  1. Open the Tree view to see the hierarchy from the root down.
  2. Click a node's expand arrow to reveal its children; click again to collapse.
  3. Read repeated steps by their numbering — numbering is sequential.
  4. Read iteration labels — they follow the execution order.
  5. Read per-node metrics on LLM nodes — duration and tokens.
  6. Click any node to load its details into the Inspector; the selection syncs with Graph and Waterfall.
  7. Expand the deepest branch to verify structure — indentation stays correct, with no truncation.

Result: You have a complete, multi-angle picture of a single run and can drill into any step.

Side Panels

Inspector / Details

The Inspector (opened via the Details side panel) shows everything about the currently selected node.

User can perform several types of actions:

  1. Open Details. With no node selected, it reads "Select a node on the canvas or in the tree sidebar to inspect it."
  2. Select a node (in Graph, Waterfall or Tree). The Inspector fills with its type, status, name, ownership and duration.
  3. Toggle Pretty for a human-readable view, or JSON for the raw payload.
  4. Expand Timing to see the node's timing breakdown.
  5. Expand References (N) to list references — the count matches the header number.
  6. Expand Metadata (N) to see metadata — the count matches the header number.
  7. If the node has no payload, Final results shows "No final result payload recorded."
  8. Click the ownership link ("in {Job}") tolinkto navigate to / highlight the parent node.
  9. Click × to close the panel.
Tool I/O

The Tool I/O panel shows the input and output of a tool call.

User can perform several types of actions:

  1. Select a tool node (e.g. "Get Project Structure"). The Tool I/O button becomes active.
  2. Open Tool I/O.
  3. Read the input — the parameters the tool was called with.
  4. Read the output — the result the tool returned.
  5. If a format toggle is available, switch between Pretty and JSON.
Dependencies

The Dependencies panel reveals scheduling dependencies between nodes.

User can perform several types of actions:

  1. Click Deps to open the dependencies panel / mode.
  2. Find a node marked "Has scheduling dependencies" — the indicator confirms it has them.
  3. Select a node that has dependencies — its related nodes / edges are highlighted.
  4. Select an independent node — no dependencies are shown (empty), confirming it isn't waiting on anything.
LLM Call
Back to top