Prometheus API

Evaluates a PromQL expression over a range of time

get/api/prometheus/api/v1/query_range

Parameters 7

queryqueryrequired

PromQL expression to evaluate.

string

startquery

Start timestamp of the range (inclusive).

stringformat "rfc3339 | unix_timestamp"

endquery

End timestamp of the range (inclusive). Must not be before start.

stringformat "rfc3339 | unix_timestamp"

stepqueryrequired

Query resolution step width, as a duration or a number of seconds.

stringformat "duration | float_seconds"

timeoutquery

Per-query timeout, clamped to the server-configured maximum.

stringformat "duration"

limitquery

Maximum number of returned series. Defaults to and is capped at the server-configured maximum.

integerformat "int64"minimum 1

datasetquery

Dataset to query. Defaults to the organization's default dataset.

References Dataset

Optional dataset to query across. Defaults to whatever is configured to be the default dataset for the organization.

stringpattern "^[a-zA-Z0-9_-]{3,26}$"

bash

Sample request12
curl --request GET 'https://api.eu-west-1.aws.dash0.com/api/prometheus/api/v1/query_range?query=up&step=1m' \
  --header "Authorization: Bearer ${DASH0_AUTH_TOKEN}"

Server

Responses

Evaluated range query. The result is always a matrix.

References PrometheusQueryResponse

stringrequired

PrometheusQueryResult

string[]

Info-level annotations produced while evaluating the query (Prometheus 3.0+), kept separate from warnings.