Hanzo
OpenapiO11y

Returns a trace's flamegraph: spans bucketed by depth level, each level ordered…

Returns a trace's flamegraph: spans bucketed by depth level, each level ordered as it is drawn, around the selected span.

POST /v1/o11y/traces/{traceId}/flamegraph

Addresshttps://api.hanzo.ai/v1/o11y/traces/{traceId}/flamegraph
MethodPOST
OperationGetFlamegraph
AuthAuthorization: Bearer $HANZO_API_KEY

Returns a trace's flamegraph: spans bucketed by depth level, each level ordered as it is drawn, around the selected span.

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

Request

9 fields, body application/json (required).

FieldInTypeRequiredDescription
traceIdpathstringyes
selectFieldsbodyo11y.TelemetryFieldKey[]
selectFields[].descriptionbodystring
selectFields[].fieldContextbodyany
selectFields[].fieldDataTypebodyany
selectFields[].namebodystringyes
selectFields[].signalbodyany
selectFields[].unitbodystring
selectedSpanIdbodystring

Response

StatusBodyMeaning
200o11y.O11yTraceFlamegraphOutok

200 body — 23 fields.

FieldInTypeAlwaysDescription
databodyo11y.GettableFlamegraphTrace
data.endTimestampMillisbodyinteger
data.hasMorebodyboolean
data.spansbodyo11y.FlamegraphSpan[][]
data.spans[][].attributesbodyobject
data.spans[][].attributes.*bodyobject
data.spans[][].durationNanobodyinteger
data.spans[][].eventbodyo11y.Event[]
data.spans[][].event[].attributeMapbodyobject
data.spans[][].event[].attributeMap.*bodyobject
data.spans[][].event[].isErrorbodyboolean
data.spans[][].event[].namebodystring
data.spans[][].event[].timeUnixNanobodyinteger
data.spans[][].hasErrorbodyboolean
data.spans[][].levelbodyinteger
data.spans[][].namebodystring
data.spans[][].parentSpanIdbodystring
data.spans[][].resourcebodyobject
data.spans[][].resource.*bodystring
data.spans[][].spanIdbodystring
data.spans[][].timestampbodyinteger
data.startTimestampMillisbodyinteger
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y traces flamegraph <traceId>

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page