feat: integrate Axiom MetricsDB/MPL querying and prioritize over Grafana

[Licenser]

Summary

Adds Axiom MetricsDB (MPL) querying capabilities and establishes Axiom as the primary metrics source, with Grafana as fallback.

New Scripts

• scripts/axiom-metrics-query — MPL query helper for otel-metrics-v1 datasets. Supports --range, --start/--end, --spec (fetch MPL language spec), --trace.
• scripts/axiom-metrics-discover — Discover metrics, tags, and tag values in MetricsDB datasets. Commands: metrics, tags, tag-values, metric-tags, metric-tag-values, search.

Discovery Changes

• scripts/discover-axiom — Now fetches the dataset catalog and tags MetricsDB datasets with [MPL] in output, so the agent knows which query language to use.

Skill & Reference Updates

• SKILL.core.md — Section 4.D (EXECUTE) now prioritizes Axiom MetricsDB for ALL OTel metrics (app and infra). Grafana/PromQL is explicitly a fallback for Prometheus-native metrics not in Axiom, plus alerts/dashboards. Sections 8.B (RED) and 8.C (USE) updated similarly.
• reference/metrics.md — New reference covering MetricsDB vs EventDB, MPL syntax, discovery workflow, query patterns, and error handling.
• reference/grafana.md — Integration section updated to reflect Axiom-first priority.

Decision Criteria

Signal	Primary Source	Fallback
App metrics (RED)	Axiom MetricsDB (MPL)	Grafana (PromQL)
Infra metrics (USE)	Axiom MetricsDB (MPL)	Grafana (PromQL)
Alerts & dashboards	Grafana	—
Logs & traces	Axiom EventDB (APL)	—

Tests

scripts/test-build: 20/20 passed.

Thread: https://ampcode.com/threads/T-019c50ea-c33a-71c5-afef-5ed7b7ce0607

---

Note

Medium Risk
Introduces new curl-based query paths and caching in discovery scripts, which could affect auth handling and dataset selection output; changes are isolated to tooling/docs but will influence incident workflows.

Overview
Adds Axiom MetricsDB support by introducing scripts/axiom-metrics-query (MPL queries + --spec, --range/--start/--end, optional trace ID printing) and scripts/axiom-metrics-discover (list/search metrics, tags, and tag values via MetricsDB info endpoints), plus a shared scripts/lib-time helper for RFC3339 time handling.

Updates Axiom dataset discovery (skill/scripts/discover-axiom) to fetch/cache the dataset catalog, tag otel:metrics:v1 datasets as [MPL], and surface MetricsDB datasets that aren’t in the “top datasets” list. Documentation/skill guidance is revised to treat Axiom (APL for logs, MPL for metrics) as the primary query path and reposition Grafana/PromQL as a fallback and alert/dashboard source; scripts/sync-to-skills and scripts/test-build are adjusted accordingly.

^{Written by Cursor Bugbot for commit cd5bfb2. This will update automatically on new commits. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
gilfoyle	Ready	Preview, Comment	Feb 18, 2026 9:57am

[tsenart]

TODO: Axiom UI needs native MPL support in initForm

Currently scripts/axiom-link uses the apl field in initForm for both APL and MPL queries — this works because the Axiom web UI accepts any text in that field and pre-fills the editor. However, the query page stays in APL mode and won't auto-detect or switch to MPL mode.

For a proper end-to-end experience, the Axiom UI should support an initForm parameter (or equivalent) that:

1. Recognizes MPL queries and switches the editor to MPL mode
2. Ideally auto-runs the query on load

Until then, the workaround is functional — the MPL query text appears in the editor, and the user can copy/paste or manually switch modes.

[gilfoyle-sre]

Resolved merge conflicts with main (skill/ directory restructure). Conflicts in SKILL.core.md and skill/SKILL.md were trivial — took the branch's MPL-aware axiom-link comments. reference/metrics.md correctly placed in skill/reference/. Tests pass.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}