Fetch one whole trace

Every span of one trace, parent links included, so a caller can rebuild the tree. Trace IDs come from the sampled spans in a diagnosis, or from any SQL query over sigiro_spans.

GET/v1/traces/{trace_id}

Path parameters

trace_idstringrequired

Trace ID

Responses

200Trace detail

critical_pathstring[]required

error_countinteger<int64>required

root_spanSpanDetailrequired

Individual span detail in trace detail response.

Show properties

duration_usinteger<int64>required

events_jsonstring | null

links_jsonstring | null

parent_span_idstring | null

resource_attributesstring | null

scope_namestring | null

scope_versionstring | null

service_namestringrequired

span_attributesstring | null

span_idstringrequired

span_kindinteger<int32> | null

span_namestringrequired

status_codeinteger<int32>required

timestampstringrequired

trace_idstringrequired

trace_statestring | null

service_breakdownServiceBreakdownEntry[]required

Show properties

Array of ServiceBreakdownEntry

duration_usinteger<int64>required

Cumulative inclusive duration of the service's spans, in microseconds.

percentagenumber<double>required

Percentage of cumulative inclusive span duration across all services.

servicestringrequired

servicesstring[]required

span_countinteger<int64>required

spansSpanDetail[]required

Show properties

Array of SpanDetail

duration_usinteger<int64>required

events_jsonstring | null

links_jsonstring | null

parent_span_idstring | null

resource_attributesstring | null

scope_namestring | null

scope_versionstring | null

service_namestringrequired

span_attributesstring | null

span_idstringrequired

span_kindinteger<int32> | null

span_namestringrequired

status_codeinteger<int32>required

timestampstringrequired

trace_idstringrequired

trace_statestring | null

total_duration_usinteger<int64>required

Elapsed wall-clock time from the earliest span start to the latest span end, in microseconds.

trace_idstringrequired

Request

curl -X GET "/v1/traces/string"

const response = await fetch("/v1/traces/string", {
  method: "GET"
});

import requests

response = requests.get(
    "/v1/traces/string",
)

Response

{
  "critical_path": [
    "string"
  ],
  "error_count": 0,
  "root_span": {
    "duration_us": 0,
    "events_json": "string",
    "links_json": "string",
    "parent_span_id": "string",
    "resource_attributes": "string",
    "scope_name": "string",
    "scope_version": "string",
    "service_name": "string",
    "span_attributes": "string",
    "span_id": "string",
    "span_kind": 0,
    "span_name": "string",
    "status_code": 0,
    "timestamp": "string",
    "trace_id": "string",
    "trace_state": "string"
  },
  "service_breakdown": [
    {
      "duration_us": 0,
      "percentage": 0.1,
      "service": "string"
    }
  ],
  "services": [
    "string"
  ],
  "span_count": 0,
  "spans": [
    {
      "duration_us": 0,
      "events_json": "string",
      "links_json": "string",
      "parent_span_id": "string",
      "resource_attributes": "string",
      "scope_name": "string",
      "scope_version": "string",
      "service_name": "string",
      "span_attributes": "string",
      "span_id": "string",
      "span_kind": 0,
      "span_name": "string",
      "status_code": 0,
      "timestamp": "string",
      "trace_id": "string",
      "trace_state": "string"
    }
  ],
  "total_duration_us": 0,
  "trace_id": "string"
}