Prometheus Remote Read Query Federation Prompt
Configure and troubleshoot remote_read so a local Prometheus transparently queries a long-term backend without doubling query load, timing out, or returning duplicate series.
- Target user
- SREs federating queries across Prometheus and a remote TSDB
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT, Cursor
The prompt
You are a senior reliability engineer who designs Prometheus remote_read
federation to a long-term backend (Thanos, Mimir, VictoriaMetrics, or a
vendor).
I will provide:
- Our `remote_read` config block and the backend type/version
- The symptom: duplicate series in query results, slow/timeout queries,
high backend fan-out, or gaps between local and remote data
- Query patterns (Grafana dashboards, recording rules, ad-hoc) and their
typical lookback windows
- Local retention and where the local/remote data boundary sits
Work through:
1. **Read topology** — clarify whether this Prometheus should serve recent
data locally and delegate only older ranges. Recommend `read_recent`
true/false and where the time boundary belongs.
2. **Query scoping** — use `required_matchers` (for example
`{__name__=~"..."}` or a tenant label) so remote_read only fires for
queries that actually need the backend, cutting fan-out.
3. **Duplicate elimination** — explain why overlapping local + remote data
produces duplicate series and how the boundary / matchers fix it.
4. **Timeout & resilience** — set `read_timeout`, and describe graceful
degradation so a slow backend does not stall the whole query path;
contrast with Thanos sidecar/Query fan-out as an alternative topology.
5. **Auth & transport** — TLS, bearer/OAuth, and compression settings for
the read path.
6. **Validation** — the exact queries to run (recent-only vs. long-range),
the `prometheus_remote_read_*` / backend request metrics to watch, and a
degraded-backend test.
Output: (a) diagnosis, (b) corrected remote_read YAML with inline comments,
(c) alternative topology recommendation if remote_read is the wrong tool,
(d) validation and rollback steps.
If the real need is global aggregation across many Prometheis, say so and
recommend a query-federation layer instead of remote_read.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Thanos Store Gateway Index & Caching Tier Sizing Prompt
Size the Thanos Store Gateway index cache, bucket cache, and caching-bucket tiers so long-range queries are fast without exhausting memory or hammering object storage.
-
Prometheus Alert Severity & Routing Taxonomy Design Prompt
Design a consistent severity label taxonomy and routing-ready label set across Prometheus alerting rules so Alertmanager can route, group, and escalate deterministically.
-
Prometheus DNS SD SRV Record Discovery Design Prompt
Design dns_sd_configs using SRV and A/AAAA records so Prometheus discovers targets from DNS reliably, with correct port handling, refresh timing, and relabeling.
-
Prometheus Kubernetes SD EndpointSlice Relabeling Design Prompt
Design robust kubernetes_sd_config relabel_configs against the endpointslice role so targets, namespaces, and pod metadata are discovered and labeled correctly at scale.
More Prometheus & Monitoring prompts & error guides
Browse every Prometheus & Monitoring prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.