obz-mimir: Grafana Mimir Provider
Quick Reference
| Field | Value |
|---|
| Aliases | mimir |
| Signal | Metric |
| Query language | PromQL |
| Auth | Bearer token or Basic auth |
| Provider flags | None |
| Supported cmds | query, list, info, labels, label-values, series |
Supported Commands
All six core metric commands work with this provider:
obz metric query # Run an instant or range PromQL query
obz metric list # List available metric names
obz metric info # Show metadata for a specific metric
obz metric labels # List all known label names
obz metric label-values # List values for a given label
obz metric series # List matching time series
Authentication
Configure auth in config.yaml under providers.<name>.auth. Supports
bearer token, basic auth, or no auth.
# config.yaml
providers:
mimir:
endpoint: https://mimir.example.com
auth:
token: ${env:MIMIR_TOKEN}
Then query with just -p:
obz metric query -p mimir -q 'up'
PromQL with Mimir
Mimir implements standard PromQL with no proprietary extensions. All valid
PromQL expressions work as-is.
Common Patterns
rate(http_requests_total[5m])
sum by (job) (up)
histogram_quantile(0.99, rate(http_duration_seconds_bucket[5m]))
avg_over_time(cpu_usage[1h])
Mimir's strength is horizontal scalability. Queries that touch large
time ranges or high-cardinality series benefit from its distributed
query engine.
Mimir vs Prometheus vs VictoriaMetrics
| Feature | Mimir | Prometheus | VM |
|---|
| PromQL | Yes | Yes | Yes |
| MetricsQL extensions | No | No | Yes |
| Horizontal scaling | Yes | No | Yes |
| Multi-tenancy | Yes | No | Yes |
Choose mimir for Grafana Mimir deployments. Use prom for standalone
Prometheus, or vm for VictoriaMetrics.
Examples
Instant query:
obz metric query -p mimir -q 'up' --from now-1h
Range query with step:
obz metric query -p mimir -q 'rate(http_requests_total[5m])' \
--from now-1d --to now --step 5m
List metric names:
obz metric list -p mimir
Find series matching a selector:
obz metric series -p mimir --match '{job="api", env="prod"}'
List values of a label:
obz metric label-values -p mimir job