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.

Back to top