Hanzo
OpenapiO11y

Returns one trace's spans as a column/row table, optionally centred on a span…

Returns one trace's spans as a column/row table, optionally centred on a span and walked a fixed number of levels up and down from it — the read the trace…

GET /v1/o11y/traces/{traceId}

Addresshttps://api.hanzo.ai/v1/o11y/traces/{traceId}
MethodGET
OperationSearchTraces
AuthAuthorization: Bearer $HANZO_API_KEY

Returns one trace's spans as a column/row table, optionally centred on a span and walked a fixed number of levels up and down from it — the read the trace explorer opens a trace with.

Callers need the viewer role; the runtime's own gate enforces it.

Request

5 fields.

FieldInTypeRequiredDescription
traceIdpathstringyes
spanIdquerystring
levelUpqueryinteger
levelDownqueryinteger
spanRenderLimitqueryinteger

Response

StatusBodyMeaning
200o11y.O11yTraceSpanWindow[]ok

200 body — 5 fields.

FieldInTypeAlwaysDescription
[].columnsbodystring[]Columns names the fields each row carries, in row order.
[].endTimestampMillisbodyintegerEndTimestampMillis is when it closes.
[].eventsbodyobject[][]Events are the rows, each positionally matching Columns.
[].isSubTreebodybooleanIsSubTree says the window is a subtree of the trace rather than the whole of it.
[].startTimestampMillisbodyintegerStartTimestampMillis is when the window opens.

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y traces get <traceId>

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page