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 linkto 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