How to build Prometheus dashboards in Metabase
Prometheus is an open-source metrics and alerting system that powers monitoring for much of the cloud-native world. Metabase is where you turn those operational signals into shared, trustworthy dashboards. This guide covers two complementary paths: a lightweight MCP + CLI route that pulls live data with the Prometheus MCP server and loads a CSV into Metabase with the Metabase CLI, and a durable pipeline route that syncs Prometheus rollups into a database so you can build dashboards anyone can read.
How do you connect Prometheus to Metabase?
Most teams combine both routes: use MCP and CLI uploads for a fast first pass, then move recurring reliability reporting to a warehouse-backed model.
Live data in, quick analysis out
Pair the Prometheus MCP server with the Metabase CLI. Use MCP for live lookups, write a scoped result to CSV, then load it into Metabase as a ready-to-query table and model.
- Quick lookups such as "show me service availability and error rate"
- Loading a Prometheus export into Metabase in seconds
- Spot-checks and one-off analyses without a warehouse
- Great for exploration, not governed reliability reporting
- Use read-only/scoped credentials wherever the MCP server supports them
- CSV uploads are snapshots — refresh or move to the pipeline for history
Durable dashboards with history
Sync Prometheus rollups and metadata into a database or warehouse with a connector, custom pipeline, or API, then point Metabase at it.
- Prometheus reliability dashboards leaders depend on
- Joining Prometheus data with deploys, issues, support, or cost data
- Long-run trends for service availability and error rate and alert volume by rule
- You own the refresh schedule and the rollup grain
- Sync aggregates and entities — not the raw event firehose
- Metric definitions must be consistent across services and teams
What can you analyze from Prometheus data in Metabase?
- Service availability and error rate — built from metric rollups and the related alerts, recording rules, scrape targets data your sync exposes.
- Alert volume by rule — built from metric rollups and the related alerts, recording rules, scrape targets data your sync exposes.
- SLO burn rate — built from metric rollups and the related alerts, recording rules, scrape targets data your sync exposes.
- Scrape target health — built from metric rollups and the related alerts, recording rules, scrape targets data your sync exposes.
- Capacity and saturation trends — built from metric rollups and the related alerts, recording rules, scrape targets data your sync exposes.
Which Prometheus dashboards should you build in Metabase?
Service health overview
The shared reliability view to build first.
- Availability by service (table)
- Error rate by service by week (line)
- Latency p95 by service (line)
- SLO compliance by service (bar)
Alert volume and noise
Whether monitors earn their pages.
- Alerts fired per week by monitor (stacked bar)
- Alert-to-incident conversion (number + trend)
- Noisiest monitors (table)
- Muted or silenced alerts (table)
Error and log trends
Where exceptions and log anomalies cluster.
- Error events by service by week (line)
- Log volume by service (bar)
- Top error signatures (table)
- New signatures this week (table)
SLO and error budget
Reliability against explicit targets.
- Error budget remaining by service (bar)
- Budget burn rate, trailing 28 days (line)
- SLO breaches this quarter (table)
- Compliance by service tier (bar)
How do you use the Prometheus MCP server with the Metabase CLI?
Pair the Prometheus MCP server with the Metabase CLI for fast, hands-on analysis. MCP is useful for scoped lookups and summarized exports; the Metabase CLI's upload command loads CSV data into Metabase and creates a ready-to-query table and model.
Example workflow
- Ask the MCP server for a summarized slice of metric rollups for the services you care about.
- Export the result as CSV, keeping stable IDs, services, environments, severities, and timestamps.
- Run
mb upload csvto load it into Metabase as a table and model, then build questions and dashboards on top.
Be honest about the limits
- MCP lookups are excellent for exploration, not scheduled reporting.
- A CSV upload is a snapshot; refresh it with
mb upload replaceor move to the pipeline for real history. - Periodic rollups (hourly or daily) are required for availability and error-rate trends.
mb upload csvneeds an uploads database configured under Admin → Settings → Uploads.
How do you set up Prometheus MCP and the Metabase CLI?
Prometheus MCP serverofficial
- Transport
- Local server (Docker, binary, or Helm) over stdio or HTTP
- Auth
- Inherits your Prometheus endpoint's auth (basic auth/TLS config)
- Best for
- Live scoped lookup and export
Metabase CLIofficial
- Install
npm install -g @metabase/cli- Auth
mb auth login- Load data
mb upload csv --file data.csv- Requires
- An uploads database (Admin → Settings → Uploads)
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"ghcr.io/tjhop/prometheus-mcp-server:latest",
"--prometheus.url", "http://localhost:9090"
]
}
}
}Now maintained under the official Prometheus GitHub org. Destructive TSDB admin tools stay disabled unless explicitly enabled — leave them off for analysis.
# Install the Metabase CLI
npm install -g @metabase/cli
# Log in (opens your browser; requires Metabase v62+)
mb auth login --url https://your-metabase.example.com
# Load a metric-rollups export — creates a table AND a model
mb upload csv --file prometheus-metric-rollups.csv --collection root
# Refresh that same table later from a new export
mb upload replace <table-id> --file prometheus-metric-rollups.csvCan you generate a Prometheus dashboard with AI?
Yes. Use the prompt below with any assistant that can run the Prometheus MCP server and the Metabase CLI. It works end to end: if Prometheus tables already exist in Metabase it analyzes those; otherwise it pulls scoped, summarized data over MCP, loads it with mb upload csv, then builds the dashboard and caveats any metric that needs missing history.
Create a polished Metabase dashboard for Prometheus observability analytics.
Work end to end: get the data into Metabase if it isn't there yet, then build.
Goal: Help engineering and operations leaders understand service availability, error rates, alert quality, and SLO compliance from Prometheus data.
Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for prometheus tables and
models). If durable Prometheus data is already present — synced from a warehouse
or uploaded earlier — use it and skip to Step 2.
- If nothing is there, pull a scoped, summarized export with the Prometheus MCP server:
metric rollups, plus alerts, recording rules, scrape targets.
Prefer aggregated or rollup views over raw events. Write each result to a CSV,
then load it with the Metabase CLI — run "mb upload csv --file <export>.csv" so
each upload creates a table and a ready-to-query model. Use "mb upload replace
<table-id> --file <export>.csv" to refresh an existing table instead of creating
duplicates.
Step 2 — Inspect before querying:
Do not assume exact table or column names. Inspect available fields, services,
environments, timestamps, and whether rollups or history exist before creating
duration or trend cards.
Important:
- Build on whatever data is present; don't claim Metabase connects natively to
Prometheus — it reads a database or CLI-uploaded tables.
- Never try to load the raw event firehose into Metabase; use rollups, entity
tables, and incident- or group-grain data.
- Only compute durations (MTTA, MTTR, time-to-resolve) when the required
timestamps exist.
- Exclude test, staging, or muted objects from headline reliability cards, and
segment by environment where the field exists.
- A single CSV is a point-in-time snapshot: only build trend cards if there is a
usable date column or multiple periods have been uploaded.
Dashboard title: Prometheus Observability Overview
Sections:
1. Executive summary: Availability last 30 days; Error rate; Alerts fired;
SLO compliance; Services below target.
2. Service health: Availability and error rate by service by week.
3. Alerts: Alert volume by monitor; conversion to incidents; noisy monitors.
4. SLOs: Error budget remaining; burn rate; breaches by service.
5. Trends: Latency percentiles and traffic by service where synced.
Filters: Date range, Service, Environment, Severity, Team, Status.
Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. Include caveats for any metric
that cannot be calculated from the available data.How do you sync Prometheus data into a database or warehouse?
For dashboards that need history and reliability, land Prometheus rollups and metadata in a database first, then connect Metabase to that database.
Connector options
- Managed ETL — use a connector when one covers the objects you need.
- Custom pipeline — use the Prometheus HTTP API for control over rollup grain, fields, and refresh cadence.
- MCP + CSV — use this for quick exploration and one-off slices.
No managed connector exists — export query_range rollups with scripts against the Prometheus HTTP API, or use remote_write into long-term storage your warehouse can reach.
Notes
- Decide the rollup grain first (hourly or daily per service/environment) — it drives warehouse cost and every trend card.
- Land raw entity tables first, then build clean Metabase models on top.
- Normalize service, environment, metric, window-start, and aggregation fields.
How should you model Prometheus data in Metabase?
Core tables
| Table | Grain | Key columns |
|---|---|---|
service_health_rollups | one row per service per hour or day | service_name, environment, window_start, total_requests, successful_requests, p95_latency_ms |
prometheus_alerts | one row per alert firing | fingerprint, rule_name, service_name, severity, fired_at, resolved_at, became_incident |
prometheus_rules | one row per recording or alerting rule | name, group_name, type, expression, labels |
Modeling advice
- Build a clean
service_health_rollupsmodel with common columns across tools, so multi-source dashboards don't fork definitions. - Separate entity tables (services, monitors, policies) from time-series rollups and event-grain tables.
- Exclude test, staging, and muted objects from headline reliability metrics; keep environment as an explicit column.
- Use stable IDs for service, team, and incident joins; display names change.
Which Prometheus metrics should you track in Metabase?
| Metric | Definition | Notes |
|---|---|---|
| Service availability | Successful requests or minutes divided by total, per service. | Define success once (status < 500, or probe-based). |
| Error rate | Error events divided by total requests per window. | Use rollups; raw events don't belong in a warehouse. |
| Alert noise rate | Alerts that led nowhere divided by all alerts fired. | Review the noisiest monitors monthly. |
| SLO compliance | Actual reliability against the SLO target and error budget. | Burn rate matters more than a point-in-time number. |
What SQL powers Prometheus dashboards in Metabase?
These assume a cleaned analytical model in a warehouse (PostgreSQL dialect). Adjust table and column names to match your pipeline.
From success/total rollups per service.
SELECT
service_name,
date_trunc('week', window_start) AS week,
ROUND(
100.0 * SUM(successful_requests) / NULLIF(SUM(total_requests), 0), 3
) AS availability_pct
FROM service_health_rollups
WHERE environment = 'production'
GROUP BY 1, 2
ORDER BY 1, 2;Which monitors page for real problems.
SELECT
monitor_name,
COUNT(*) AS alerts_fired,
COUNT(*) FILTER (WHERE became_incident) AS incidents,
ROUND(
100.0 * COUNT(*) FILTER (WHERE became_incident)
/ NULLIF(COUNT(*), 0), 1
) AS conversion_rate
FROM alerts
WHERE fired_at >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY monitor_name
ORDER BY alerts_fired DESC
LIMIT 20;Actual reliability vs. the published target, trailing 28 days.
SELECT
service_name,
slo_target,
ROUND(
100.0 * SUM(successful_requests) / NULLIF(SUM(total_requests), 0), 3
) AS actual,
ROUND(
100.0 * SUM(successful_requests) / NULLIF(SUM(total_requests), 0), 3
) - slo_target AS margin
FROM service_health_rollups
WHERE window_start >= CURRENT_DATE - INTERVAL '28 days'
GROUP BY service_name, slo_target
ORDER BY margin ASC;