Configure Prometheus federation to aggregate metrics from multiple Prometheus servers into a global view

domain: prometheus.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. On each source Prometheus server, the built-in /federate endpoint is always available; it exposes the current value of selected time series based on match[] URL parameters.
  2. On the global/aggregating Prometheus, add a scrape_configs job with honor_labels: true and metrics_path: '/federate', targeting the source servers' host:port as static_configs targets.
  3. Add one or more params: match[] entries to select which series to pull, e.g. match[]: ['{job="prometheus"}'] or match[] on specific metric name prefixes; multiple match[] values are unioned.
  4. Set honor_labels: true so that labels already present on the scraped (federated) series take precedence over the global Prometheus's own server-side labels, preserving the original instance/job identity.
  5. Reload the global Prometheus config and confirm via its targets page that the federation scrape job is healthy and the federated series appear in queries.
  6. Prefer federating aggregated/recording-rule metrics rather than raw high-cardinality series, since federation is a pull-based full scrape of the matched series on every scrape interval.

Known gotchas

Related routes

Configure Prometheus remote_write to forward metrics to a remote storage backend
prometheus.io · 5 steps · unrated
Set up Grafana Mimir for long-term Prometheus metric storage with multi-tenancy
grafana.com · 6 steps · unrated
Configure the Kubernetes Prometheus Adapter to expose custom Prometheus metrics for the Horizontal Pod Autoscaler
github.com/kubernetes-sigs/prometheus-adapter · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans