obz-prometheus: Prometheus Provider
Quick Reference
| Field | Value |
|---|
| Aliases | prom, prometheus |
| 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:
prom:
endpoint: http://localhost:9090
auth:
token: ${env:PROM_TOKEN}
For basic auth:
auth:
username: admin
password: ${env:PROM_PASS}
Then query with just -p:
obz metric query -p prom -q 'up'
PromQL Guide
Prometheus uses standard PromQL. Unlike VictoriaMetrics, there are no
MetricsQL extensions like keep_metric_names or range_normalize.
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])
Duration Units
PromQL supports ms, s, m, h, d, w, y. Note that d always
means exactly 24h and w means 7d, with no calendar awareness.
Examples
Instant query:
obz metric query -p prom -q 'up' --from now-1h
Range query with step:
obz metric query -p prom -q 'rate(http_requests_total[5m])' \
--from now-1d --to now --step 5m
List metric names:
obz metric list -p prom
Find series matching a selector:
obz metric series -p prom --match '{job="api", env="prod"}'
List values of a label:
obz metric label-values -p prom job
Prometheus vs VictoriaMetrics
| Feature | Prometheus | VictoriaMetrics |
|---|
| PromQL | Yes | Yes |
| MetricsQL extensions | No | Yes |
keep_metric_names | No | Yes |
range_normalize | No | Yes |
d/w duration units | Yes | Yes |
If you find yourself needing MetricsQL-only features, switch to the vm
provider instead.