mirror of
https://github.com/prometheus/prometheus.git
synced 2025-08-06 14:17:12 +02:00
0fb698675c
Left over of the master->main branch rename. Signed-off-by: Julien Pivotto <291750+roidelapluie@users.noreply.github.com>
25 lines
858 B
Markdown
25 lines
858 B
Markdown
---
|
|
title: Remote Read API
|
|
sort_rank: 7
|
|
---
|
|
|
|
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](https://github.com/google/snappy) compression.
|
|
The API definition is located [here](https://github.com/prometheus/prometheus/blob/main/prompb/remote.proto).
|
|
|
|
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](http://www.vldb.org/pvldb/vol8/p1816-teller.pdf)
|
|
compression to encode the chunks. However, it provides resolution to the millisecond instead of to the second.
|