Skip to main content
IronBee records a trace for each verification cycle, an OpenTelemetry-compatible log of every tool call the agent made, organized as a hierarchy of spans. The trace is visualized as an interactive waterfall chart inside the verification detail panel. IronBee Console — Traces

​
How to access traces

Traces are embedded in the Verification Detail panel, they are not a standalone page.
  1. Open a session and go to the Timeline tab
  2. Click a verification event in the timeline to open the Verification panel
  3. Click the Traces button in the verification header
The panel opens to the right. The URL updates with tracesOpen=true so you can link directly to it.

​
Traces panel

The panel header shows a count badge, for example 5 / 12 means 5 spans match the current filters out of 12 total.

​
View toggle

​
Waterfall chart

The chart has two columns: Left label panel (frozen)
  • Span name
  • Service name (color-coded)
  • OpenTelemetry span kind icon
  • Collapse / expand chevron for parent spans
Right chart area
  • Horizontal bars representing span duration
  • Time axis (in seconds) pinned to the bottom
  • Bars colored by status

​
Span status colors

Each unique service name also gets a stable color from a 24-color palette.

​
Span kind icons

Kinds follow OpenTelemetry conventions: INTERNAL, CLIENT, SERVER, PRODUCER, CONSUMER.

​
Filters

Active filter chips appear below the toolbar. The count badge updates as you filter.

​
Interacting with the chart

Navigate:
  • Vertical scroll browse rows
  • Horizontal drag pan left/right within the chart area (click and drag on the background)
Explore spans:
  • Hover a bar tooltip shows span name, service, kind, duration, status
  • Click a bar opens the span JSON modal
  • Click a label scrolls the chart horizontally to bring that span’s bar into view
  • Chevron collapse or expand a span’s children
Playback mode (when the verification video is playing):
  • A vertical playhead line tracks the current video position
  • The active span is highlighted in gold
  • Parent and sibling spans in the call chain are also highlighted
  • The chart auto-scrolls to keep the active span visible
  • Seek button on each bar click to jump the video to that span’s start time

​
Span JSON modal

Click any span bar to open its detail modal:
  • Header: service name · span name, Copy JSON button
  • Metadata row: span_id, trace_id, parent_span_id, kind, status, duration
  • Data section: full key-value view of the span payload, including any custom data fields
The Copy button copies the complete span as formatted JSON.