Turn a raw trace into a readable timeline.
How to use Agent Trace Viewer
Add a trace file. Drop your trace onto the uploader or pick it from your device. Only one file is accepted at a time.
Check the overview. Read the Spans count, the Total duration and the Agents found in the trace.
Read the timeline. The Timeline panel lists spans as a nested waterfall. Each row shows the span name, its agent, a bar placed by start time and its duration. Child spans are indented under their parent.
Spot problems. Error spans carry an alert icon and successful spans a check icon. Each agent gets its own bar color.
Limits and privacy
- The maximum file size is 25 MB.
- The uploader accepts code or config file extensions: .json, .yaml, .yml, .log, .toml, .ts, .js and .py. A .jsonl extension is not accepted, so save line-delimited traces as .log or .json.
- The content can be a JSON array of spans, an object with a spans, data, events or trace array, a single span object, or one JSON object per line.
- Each span needs a start time in a field like start_time, startTime, start_ts, start, ts or timestamp. Spans without one are dropped.
- Other fields are matched by common names: id, span_id or spanId; parent_span_id, parentSpanId or parent_id; name, event or operation; agent, actor or role; end_time or duration_ms for the end.
- Timestamps may be seconds, milliseconds, microseconds, nanoseconds or ISO date strings. The unit is guessed from the size of the number.
- In JSONL content, lines that are not valid JSON are skipped.
- Status is read as ok or error from values such as ok, success, error or failed. Anything else shows no icon.
- Parsing runs in your browser. The file is not uploaded.
Frequently asked questions
What trace formats does it accept?
JSON arrays of spans, objects wrapping a spans, data, events or trace array, and one-JSON-object-per-line content. Field names are matched flexibly, so OpenTelemetry-style and hand-rolled logs often work.
Why does it say no spans were found?
Either the file held no JSON objects or none of them had a recognizable start time field, such as start_time, startTime or timestamp.
Can I upload a .jsonl trace?
Not with that extension. Rename the file to .log or .json and it will be accepted and parsed as line-delimited JSON.
Is my trace sent to a server?
No. The file is read and parsed in your browser.