This is documentation for the next version of Mimir. For the latest stable release, go to the latest version.

Documentation Grafana Mimir Query

Query metric data from Grafana Mimir

You can query data from Grafana Mimir via Grafana or the Grafana Mimir HTTP API.

The Grafana Mimir HTTP API is compatible with the Prometheus HTTP API.

To understand how you can query Prometheus data from within Mimir, refer to Querying Prometheus, which introduces you to Prometheus Query Language (PromQL).

Understand how range queries are cached

By default, Mimir caches a range query only if the query is aligned. A query is aligned when both the start and end parameters are multiples of its step.

Mathematically, it looks as follows:

Copy

start modulo step = 0

AND

Copy

end modulo step = 0

Otherwise, a query is unaligned and it is not cached.

If you are querying from within Grafana, queries are aligned for you automatically. If you invoke the Grafana Mimir HTTP API directly, make sure that your range queries are aligned in order to benefit from caching.

• Query metric labels