v1

latestOpenAPI 3.0.02026-08-064311,0881.3 MB

traces

Get a list of trace spans.

Get a list of spans for the given trace. The response is paginated with a default limit of 100 spans per page.

get/v1/tracing/traces/{traceId}/spans

Path parameters

traceIdstring required

Identifier of the trace to get the spans.

Query parameters

limitinteger

The maximum number of results to fetch.

tokenstring

Continuation token to get the next page of results. A page object with the next continuation token is returned in the response body. Subsequent GET requests should specify the continuation token to get the next page of results. token is set to null when no more pages are left.

Response

List of spans for the given trace.

totalCountinteger required

Total count of spans for this trace.

nextstring

Next continuation token.

Example response

{
  "spanPage": [
    {
      "id": "00000000002317A9",
      "parentId": "000000000003C7BE",
      "operationName": "retrieveAccount",
      "resource": "http.request",
      "service": "user-service",
      "serviceColor": "#fa41c6",
      "serviceType": "HTTP",
      "duration": 212957153,
      "startedAt": "2019-11-22T09:00:00Z",
      "status": {
        "code": "OK",
        "message": "404"
      },
      "kind": "SERVER",
      "remoteService": "external-service",
      "remoteServiceColor": "#fa41c6",
      "remoteServiceType": "HTTP",
      "info": {
        "type": "TraceHttpSpanInfo"
      },
      "numberOfLinks": 2
    }
  ],
  "totalCount": 1234,
  "next": "dlFXd0lhSkxzRjAwYnpVZkMrRmlhYnF4cGtNMWdnVEI"
}