Skip to content
sigiro
Esc
navigateopen⌘Jpreview

GET /v1/traces/{trace_id} -- return a single trace with full detail including critical path and service breakdown.

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
percentagenumber<double>required
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
trace_idstringrequired
Request
curl -X 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,
      "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"
}