get_trace_detail

POST

/traces/v2/detail

curl --request POST \
  --url https://api.siteqwality.com/traces/v2/detail \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "trace_id": "example", "range": { "from": "example", "to": "example" } }'

• Production

Authorizations

• bearer_auth

Request Body ^required

Media type application/json

object

trace_id

required

string

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

Example ^generated

{
  "trace_id": "example",
  "range": {
    "from": "example",
    "to": "example"
  }
}

Responses

200

OK

Media type application/json

object

trace_id

required

string

spans

required

Array<object>

object

trace_id

required

string

span_id

required

string

parent_span_id

required

string

start_time

required

string

duration_ns

required

string

received_at

required

string

name

required

string

kind

required

string

status

required

string

status_message

required

string

service

required

string

env

required

string

version

required

string

host

required

string

flags

required

integer format: int32

scope_name

required

string

scope_version

required

string

attributes_string

required

object

key

additional properties

string

attributes_number

required

object

key

additional properties

number | null format: double

attributes_bool

required

object

key

additional properties

boolean

resource_attributes

required

object

key

additional properties

string

meta

required

object

from

required

string

to

required

string

clamped_from

string | null

partial

required

boolean

slow_terms

required

Array<string>

Example ^generated

{
  "trace_id": "example",
  "spans": [
    {
      "trace_id": "example",
      "span_id": "example",
      "parent_span_id": "example",
      "start_time": "example",
      "duration_ns": "example",
      "received_at": "example",
      "name": "example",
      "kind": "example",
      "status": "example",
      "status_message": "example",
      "service": "example",
      "env": "example",
      "version": "example",
      "host": "example",
      "flags": 1,
      "scope_name": "example",
      "scope_version": "example",
      "attributes_string": {
        "additionalProperty": "example"
      },
      "attributes_number": {
        "additionalProperty": 1
      },
      "attributes_bool": {
        "additionalProperty": true
      },
      "resource_attributes": {
        "additionalProperty": "example"
      }
    }
  ],
  "meta": {
    "from": "example",
    "to": "example",
    "clamped_from": "example",
    "partial": true,
    "slow_terms": [
      "example"
    ]
  }
}

400

Invalid query, data contains QueryError

403

Signal restricted

429

Read quota exhausted

503

Telemetry paused, busy or unavailable

504

Narrow the query