docs: revamp metrics guide

[smeubank]

I have read the CONTRIBUTING.md file.

YES

What kind of change does this PR introduce?

docs update

What is the current behavior?

Metrics API page is just very verbose and not easy to parse in a choose your own destiny kind of way

What is the new behavior?

IMHO :D a bit more user friendly

Additional context

Inital preview of Metrics API home

• Rebuilt the Metrics landing page as a true hub: cleaned hero copy, added the reusable , and added for the four integration paths (apps/docs/content/guides/telemetry/metrics.mdx).
• Added dedicated sub-guides for Grafana Cloud, Grafana + self-hosted Prometheus, Datadog, and vendor-agnostic setups, each embedding the shared access section plus vendor-specific callouts (apps/docs/content/guides/telemetry/metrics/*).
• Introduced reusable components for the access instructions and stack cards, wired them into the MDX runtime, and updated the nav constants so the new guides appear in the sidebar (apps/docs/components/MetricsAccessSection.tsx, MetricsStackCards.tsx, apps/docs/features/docs/MdxBase.shared.tsx, NavigationMenu.constants.ts).

[supabase]

This pull request has been ignored for the connected project xguihxuzqibwxjnimxev because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

---

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Dec 2, 2025 7:23pm

7 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
studio	Ignored			Dec 2, 2025 7:23pm
cms	Skipped			Dec 2, 2025 7:23pm
design-system	Skipped			Dec 2, 2025 7:23pm
studio-self-hosted	Skipped			Dec 2, 2025 7:23pm
studio-staging	Skipped			Dec 2, 2025 7:23pm
ui-library	Skipped			Dec 2, 2025 7:23pm
zone-www-dot-com	Skipped			Dec 2, 2025 7:23pm

[github-actions]

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

rdjsonl

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Kubernetes (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 7 in 59f4152

Self-hosting <a href="https://prometheus.io/docs/prometheus/latest/installation/" target="_blank" rel="noreferrer">Prometheus</a> and Grafana gives you full control over retention, alert routing, and dashboards. The Supabase Metrics API slots into any standard Prometheus scrape job, so you can run everything locally, on a VM, or inside Kubernetes.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule002AdmonitionTypes] Allowed admonition types are: note, tip, caution, deprecation, danger. Got: "info". (configure rule at supa-mdx-lint.config.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 11 in 59f4152

<Admonition type="info">

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Alertmanager (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 21 in 59f4152

3. (Optional) **Alertmanager** or your preferred system sends notifications when Prometheus rules fire.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Alertmanager (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 68 in 59f4152

- Route notifications via Alertmanager, Grafana OnCall, PagerDuty, or any other supported destination.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: OnCall (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 68 in 59f4152

- Route notifications via Alertmanager, Grafana OnCall, PagerDuty, or any other supported destination.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: PagerDuty (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/grafana-self-hosted.mdx

Line 68 in 59f4152

- Route notifications via Alertmanager, Grafana OnCall, PagerDuty, or any other supported destination.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: VictoriaMetrics (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 7 in 59f4152

The Supabase Metrics API is intentionally vendor-agnostic. Any collector that can scrape a Prometheus text endpoint over HTTPS can ingest the data. This guide explains the moving pieces so you can adapt them to AWS Managed Prometheus, Grafana Mimir, VictoriaMetrics, Thanos, or any other system.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Thanos (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 7 in 59f4152

The Supabase Metrics API is intentionally vendor-agnostic. Any collector that can scrape a Prometheus text endpoint over HTTPS can ingest the data. This guide explains the moving pieces so you can adapt them to AWS Managed Prometheus, Grafana Mimir, VictoriaMetrics, Thanos, or any other system.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: VictoriaMetrics (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 13 in 59f4152

- **Collector** – Prometheus, Grafana Agent, VictoriaMetrics agent, Mimir scraper, etc.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Thanos (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 14 in 59f4152

- **Long-term store (optional)** – Managed Prometheus, Thanos, Mimir, VictoriaMetrics.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: VictoriaMetrics (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 14 in 59f4152

- **Long-term store (optional)** – Managed Prometheus, Thanos, Mimir, VictoriaMetrics.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Datadog (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 15 in 59f4152

- **Visualization/alerting** – Grafana, Datadog, New Relic, custom code.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Distro (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 39 in 59f4152

- **AWS Managed Prometheus (AMP):** deploy the Grafana Agent or AWS Distro for OpenTelemetry (ADOT) in your VPC, then remote-write the scraped metrics into AMP.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: VictoriaMetrics (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 40 in 59f4152

- **VictoriaMetrics / Mimir:** reuse the same scrape block; configure remote-write or retention rules as needed.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: PagerDuty (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 57 in 59f4152

- Pipe alerts into PagerDuty, Slack, Opsgenie, or any other compatible target.

---

🚫 [rdjsonl] _{reported by reviewdog 🐶}
[Rule003Spelling] Word not found in dictionary: Opsgenie (configure rule at supa-mdx-lint/Rule003Spelling.toml)

supabase/apps/docs/content/guides/telemetry/metrics/vendor-agnostic.mdx

Line 57 in 59f4152

- Pipe alerts into PagerDuty, Slack, Opsgenie, or any other compatible target.