Skip to main content
POST
/
query
/
traces
Query traces
curl --request POST \
  --url https://api.alerty.ai/query/traces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "start_time": "2023-01-01T00:00:00Z",
  "end_time": "2023-01-02T00:00:00Z",
  "service_name": "<string>",
  "span_name": "<string>",
  "limit": 100
}
'
[
  {
    "timestamp": "2023-11-07T05:31:56Z",
    "trace_id": "<string>",
    "span_id": "<string>",
    "parent_span_id": "<string>",
    "trace_state": "<string>",
    "span_name": "<string>",
    "span_kind": "<string>",
    "service_name": "<string>",
    "resource_attributes": {},
    "scope_name": "<string>",
    "scope_version": "<string>",
    "span_attributes": {},
    "duration": 123,
    "status_code": "<string>",
    "status_message": "<string>",
    "events": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "attributes": {}
      }
    ],
    "links": [
      {
        "trace_id": "<string>",
        "span_id": "<string>",
        "trace_state": "<string>",
        "attributes": {}
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
start_time
string<date-time>

Start time for the query.

Example:

"2023-01-01T00:00:00Z"

​
end_time
string<date-time>

End time for the query.

Example:

"2023-01-02T00:00:00Z"

​
service_name
string

Filter traces by service name.

​
span_name
string

Filter traces by span name.

​
limit
integer
default:100

Limit the number of results.

Response

Traces retrieved

​
timestamp
string<date-time>
​
trace_id
string
​
span_id
string
​
parent_span_id
string
​
trace_state
string
​
span_name
string
​
span_kind
string
​
service_name
string
​
resource_attributes
object
​
scope_name
string
​
scope_version
string
​
span_attributes
object
​
duration
integer
​
status_code
string
​
status_message
string
​
events
object[]
​
links
object[]