Agent skill · data analytics · axiomhq
query-metrics
Runs metrics queries against Axiom MetricsDB via scripts. Discovers available metrics, tags, and tag values. Use when asked to query metrics, explore metric datasets, check metric values, or investigate OTel metrics data.
Why this skill is useful
Adds specific scripts for querying Axiom MetricsDB that include domain-specific knowledge and commands not commonly known.
What it needs
Requires axiom installed locally. About 6k tokens when loaded. Last updated 2026-07-14. 14 stars on the source repository.
What this skill does
Querying Axiom Metrics All script paths are relative to this skill's folder; invoke as scripts/<name>. The target dataset must be of kind otel:metrics:v1. Setup, prerequisites, and ~/.axiom.toml configuration: see README.md. Edge-deployment routing is automatic — the scripts read each dataset's edgeDeployment and route to the right regional endpoint without configuration. Workflow 1. scripts/datasets <deploy> --kind otel:metrics:v1 — list metrics datasets. 2. scripts/metrics-spec — required before composing any query. MPL evolves; the spec is the source of truth. Also use it to answer general MPL/metrics questions. 3. scripts/metrics-info <deploy> <dataset> metrics — list metrics with {type, temporality, unit} metadata. Read this before writing the query (see Choosing a Query Shape). 4. scripts/metrics-info <deploy> <dataset> tags [<tag> values] — explore filter dimensions. 5. scripts/metrics-query <deploy> '<MPL>' <start> <end> — execute. Iterate. If the user names a specific entity (service, host, …), scripts/metrics-info <deploy> <dataset> find-metrics "<value>" finds the metrics carrying it. find-metrics searches tag values, not metric names — don't use it for general discovery. Choosing a Query Shape The metrics-info listing returns each metric's {type, temporality, unit}. Read these before composing — never assume a metric is a simple scalar. Field Values Drives --- --- --- type Gauge, CounterMonotonic, CounterNonMonotonic, Histogram Required pre-aggregation operators. temporality Cumulative, Delta, null Whether counter values are running totals or per-interval deltas. null is normal for Gauges. unit UCUM string (Cel, kW.h, s, %, [ppm], …) or null Display unit; preserve when reporting results. Rules per type (consult metrics-spec for exact operator names — they evolve): Gauge — instantaneous value. Align directly with avg/min/max/sum. Don't apply a rate; you'd be averaging meaningless deltas of an instantaneous value. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills axiomhq/query-metrics