Runs
Traces
Inspect local Studio traces for model generations and tool calls.
Studio adds a local trace observer when trace storage is available. Runs with a session get trace metadata automatically.
List Traces
curl http://localhost:4021/tracesFilter by agent, session, or status.
curl 'http://localhost:4021/traces?agentId=support-operations&status=success'curl http://localhost:4021/sessions/session_123/tracesThe status query parameter accepts running, success, or error.
Read a Trace
curl http://localhost:4021/traces/trace_123Traces include:
| Field | Meaning |
|---|---|
status | running, success, or error |
output | Final agent output when available |
usage | Token usage from the model response |
observations | Model generation and tool execution spans |
metadata | Agent id, trace tags, user id, and run metadata |
For external observability, use Langfuse. Studio traces are local and optimized for the development UI.
