observe_traces_get

Tool

observe_traces_get

Read every span of one trace of the current product, oldest first, as a flat list carrying parentSpanId and depth — enough to draw a waterfall without a second call.

Read every span of one trace of the current product, oldest first, as a flat list carrying parentSpanId and depth — enough to draw a waterfall without a second call. Span events are returned exactly as the emitter sent them. Up to 5000 spans.

Behavior

HTTP: GET /observe/traces/:traceId

Arguments

Name	Type	Required	Description
traceId	string	•	The trace to render, by its 32-character hex id

Response

Field	Type	Always	Description
spans	array	•	Every span of the trace, oldest first; empty when the product has no such trace
traceId	string	•	The trace that was read

Try it

Read every span of one trace of the current product, oldest first, as a flat list carrying parentSpanId and depth — enough to draw a waterfall without a second call.

When to use

Example

Ask your agent something like this:

Read every span of one trace of the current product, oldest first, as a flat list carrying parentSpanId and depth — enough to draw a waterfall without a second call.

The agent will invoke observe_traces_get with these arguments:

{
  "traceId": "<traceId>"
}