metrics

GET /api/v1/metrics/checks/raw/

Returns raw per-measurement rows from the MDB ClickHouse table for one check.

No time bucketing, no aggregation — one row per stored measurement.

data_type is optional: when omitted the API resolves the check's check type and uses the first matching data type.

Accepts both GET (with repeated-key params for metrics and dimension filters) and POST (with the same fields as a JSON body).

Request

Query parameters

check_idinteger required

The check to query.

data_typestring

MDB data type (e.g. http, pagespeed, float). When omitted, resolved from the check's check type.

unknown

Metric names to return. Pass as repeated query params in GET (metrics=a&metrics=b) or as a JSON array in POST. When omitted, only the first metric defined for the data type is returned. Always specify the metrics you actually need. The default selection is not part of the API contract and may change.

start_datestring

Range start (ISO 8601, UTC). Defaults to 1 hour ago.

end_datestring

Range end (ISO 8601, UTC). Defaults to now.

filtersobject

Dimension filters (POST only). Object with dimension names as keys and arrays of values: {"location": ["us-east-1"]}. In GET, pass dimensions as direct query params instead (location=us-east-1&location=eu-west-1).

order_bystring

Column to sort by (default: check_time).

order'asc' | 'desc'

Sort direction (default: asc).

limitinteger

Max rows (default: 5000, max: 50000).

offsetinteger

Row offset for pagination (default: 0).

Response

check_idinteger required

The check to query.

data_typestring

MDB data type (e.g. http, pagespeed, float). When omitted, resolved from the check's check type.

metricsstring[]

Metric names to return. Pass as repeated query params in GET (metrics=a&metrics=b) or as a JSON array in POST. When omitted, only the first metric defined for the data type is returned. Always specify the metrics you actually need. The default selection is not part of the API contract and may change.

start_datestring date-time

Range start (ISO 8601, UTC). Defaults to 1 hour ago.

end_datestring date-time

Range end (ISO 8601, UTC). Defaults to now.

filtersobject

Dimension filters (POST only). Object with dimension names as keys and arrays of values: {"location": ["us-east-1"]}. In GET, pass dimensions as direct query params instead (location=us-east-1&location=eu-west-1).

order_bystring

Column to sort by (default: check_time).

order'asc' | 'desc'

Sort direction (default: asc).

limitinteger nullable

Max rows (default: 5000, max: 50000).

offsetinteger

Row offset for pagination (default: 0).

Changes

No recorded changes to this operation across all 1 revision of this API.