> ## Documentation Index
> Fetch the complete documentation index at: https://traceroot.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Live Tracing

> Watch spans stream into the trace viewer in real time while your agent is still running

When you open a trace whose root span hasn't ended yet, traceroot streams new spans into the viewer as they arrive. You don't need a toggle or an SDK flag — live tracing is on by default for every in-flight trace.

![Traces list with the Live toggle highlighted in the toolbar](https://mintcdn.com/tracerootai/TLv21OVXbJzkJk5L/images/trace_live_toggle_v1.png?fit=max\&auto=format\&n=TLv21OVXbJzkJk5L\&q=85\&s=76e6ccb5f8d5b36222a4d901f7549e7d)

Traces list: Live toggle beside Columns and the date range

The **Live** switch on the Traces list is separate: it refreshes the list every 5 seconds.

## How spans arrive

Spans are merged into the existing tree by span ID, so they can arrive in any order:

* Newly started spans appear as **pending** rows (greyed out, no duration yet).
* When a pending span finishes, its end time fills in and the row renders normally.
* The [Timeline View](https://traceroot.ai/docs/tracing/timeline.md) updates in step — bars extend and new bars appear.

Once the root span completes, the viewer makes a final consistency pass and stops streaming.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.