Skip to main content
POST
Get a performance action's trace
For the other ways to fetch a trace’s spans, see Querying traces.

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>

Body

application/json

The performance action whose trace to fetch.

site_ids
string[]
required

Sites to search; the token must have access to all of them.

action_name
string
required

Name of the action, e.g. POST /api/users.

namespace
string
required

Namespace of the action, e.g. web.

trace_id
string | null

A specific trace ID, or "last" (the default) for the most recent trace of the action.

Response

The trace's spans.

start_time
string<date-time>
required

Timestamp when the span started.

end_time
string<date-time>
required

Timestamp when the span ended.

site_id
string
required

Identifier of the site this span belongs to.

trace_id
string
required

Unique identifier for the entire trace.

parent_span_id
string
required

Span ID of the parent span, empty for root spans.

span_id
string
required

Unique identifier for this span.

digest
string
required

Hash digest identifying the span's operation.

duration
number<double>
required

Duration of the span in milliseconds.

trace_state
string
required

W3C trace state header value.

subtrace_root
boolean
required

Whether this span is the root of a subtrace (a separate service boundary).

resource_attributes
object
required

Resource-level attributes (e.g. host, service metadata).

service_name
string
required

Name of the service that produced this span.

namespace
string
required

Namespace the span belongs to (e.g. "web", "background").

revision
string
required

Git revision or deployment identifier active when the span was recorded.

scope_name
string
required

Instrumentation scope name (e.g. the library that produced the span).

scope_version
string
required

Instrumentation scope version.

action_name
string
required

Action name for the span (e.g. "POST /api/users").

span_name
string
required

Low-cardinality name of the operation (e.g. "HTTP GET").

span_kind
string
required

Span kind (e.g. "server", "client", "internal").

span_attributes
object
required

Span-level attributes (e.g. HTTP headers, database statements).

status_code
string
required

OpenTelemetry status code: "unset", "ok" or "error".

status_message
string
required

Human-readable status message, typically set on error.

events.timestamp
string[]
required

Timestamps of span events.

events.name
string[]
required

Names of span events (e.g. "exception").

events.attributes
object[]
required

Attributes for each span event.

Trace IDs of linked spans.

Span IDs of linked spans.

Trace state values of linked spans.

Attributes for each span link.