obz-mimir

# 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. ```yaml # config.yaml providers: mimir: endpoint: https://mimir.example.com auth: token: ${env:MIMIR_TOKEN} ``` Then query with just `-p`: ```bash 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**: ```bash obz metric query -p mimir -q 'up' --from now-1h ``` **Range query with step**: ```bash obz metric query -p mimir -q 'rate(http_requests_total[5m])' \ --from now-1d --to now --step 5m ``` **List metric names**: ```bash obz metric list -p mimir ``` **Find series matching a selector**: ```bash obz metric series -p mimir --match '{job="api", env="prod"}' ``` **List values of a label**: ```bash obz metric label-values -p mimir job ```