Zipkin compatible API

Definitions for Zipkin compatible API, queryable via the Grafana datasource integration.

Get trace by ID

GET /api/v2/trace/{traceId}

Retrieve all spans matching a given trace ID

ParameterInTypeDescription
traceIdpathstringTrace identifier, set on all spans within it.
startTimeEpochMsquerynumberStart time filter in epoch milliseconds
startTimeEpochMsquerynumberEnd time filter in epoch milliseconds
startTimeEpochMsqueryintegerMaximum number of spans to return

Response (200)

[
     {
         "id": "7c52ad9bb8f83565",
         "name": "GET",
         "remoteEndpoint": {
             "serviceName": "astraQuery" 
         },
         "tags": {
             "remote_endpoint_ipv4": "10.100.10.100",
             "_timesinceepoch": "2024-04-11T22:04:44.793Z",
             "http.path": "/metrics",
             "http.url": "http://10.199.199.199:8080/metrics",
             "http.protocol": "h1c",
             "env": "prod",
             "http.host": "10.199.199.199:8080",
             "duration": "3516",
             "local_endpoint_ipv4": "10.199.199.199",
             "_span_type": "SERVER",
             "clusterName": "index-example",
             "address.remote": "/10.100.10.100:47736",
             "address.local": "/10.199.199.199:8080",
             "http.method": "GET"
         },
         "timestamp": 1712873084793000,
         "traceId": "7c52ad9bb8f83565"
     }
 ]
            

Search traces

GET /api/v2/traces

Response (200)

[]
            

List services

GET /api/v2/services

Response (200)

[]
            

List spans by service

GET /api/v2/spans

Response (200)

[]