Remote Read API

NOTE: This is not currently considered part of the stable API and is subject to change even between non-major version releases of Prometheus.

This API provides data read functionality from Prometheus. This interface expects snappy compression. The API definition is located here. Protobuf definitions are also available on buf.build.

Request are made to the following endpoint.

/api/v1/read

Samples

This returns a message that includes a list of raw samples matching the requested query.

Streamed Chunks

These streamed chunks utilize an XOR algorithm inspired by the Gorilla compression to encode the chunks. However, it provides resolution to the millisecond instead of to the second.