For the complete documentation index, see llms.txt. This page is also available as Markdown.

Traces

Upload, browse, and inspect agent traces in Stratix Premium.

Available in Stratix Premium. This surface is part of the logged-in workspace at stratix.layerlens.ai. Stratix Public users can browse the catalog but cannot use this feature.

The Traces surface ingests agent run records and lets you inspect them in detail. URL: stratix.layerlens.ai/dashboard/agent-evaluation/traces.

What you can do

  • Upload a trace JSON file (single trace or batch)

  • Stream traces in via the SDK or API

  • Browse all traces in your org

  • Filter by date, name, tag, status

  • Inspect a single trace's full span tree, inputs, outputs, latencies, costs, errors

  • Tag and annotate traces

Trace shape

Minimum:

{
 "id": "trace-123",
 "name": "answer-question",
 "inputs": {"prompt": "What's the capital of France?"},
 "outputs": {"response": "Paris."},
 "spans": [
 {"name": "llm-call", "kind": "llm", "model": "claude-opus-4-7",...},
 {"name": "tool-call", "kind": "tool", "tool": "lookup_country",...}
 ]
}

Stratix preserves any additional fields. The trace inspector renders metadata, spans, and any custom fields.

Inspecting a trace

The trace page shows:

  • Inputs and outputs at the top level

  • Span tree with timing and cost rolled up per span

  • Per-span details (kind, model, inputs, outputs, errors)

  • Tags and annotations

Streaming traces

For continuous evaluation, stream traces via the SDK:

See the SDK reference for batch ingestion patterns.

Datasets and trace sets

Group traces into a dataset — a named, versioned collection — to make them the reusable input to a trace evaluation. Create one from any filtered trace list, upload traces from a file, or generate synthetic traces when you don't have enough real ones yet.

  • Datasets — create, version, and evaluate collections of traces

  • Synthetic data — generate realistic multi-agent trace datasets from scratch

Where to next

Last updated

Was this helpful?