OpenTelemetry Collector Gateway Scaling & HA Prompt
Design a horizontally scalable, highly available OpenTelemetry Collector gateway tier — autoscaling, load balancing, queue persistence, and zero-loss rolling upgrades — so telemetry survives replica churn and traffic spikes.
- Target user
- Platform and observability engineers operating a Collector gateway fleet
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT, Cursor
The prompt
You are a senior observability engineer who runs OpenTelemetry Collector gateway tiers as reliable, scalable infrastructure. I will provide: - Current gateway deployment (replica count, CPU/memory requests/limits, Collector version, distro) - Ingest volume per signal (spans/sec, datapoints/sec, log lines/sec) with peak-to-average ratio and known spike patterns - Whether the gateway does stateful work: tail_sampling, spanmetrics/servicegraph connectors, dedup, or grouping - Backends downstream and their rate limits, plus current pain (drops during deploys, OOMs, uneven load, cost) - The orchestrator (Kubernetes, ECS, VMs) and any autoscaling already in place Your job: 1. **Topology** — confirm the agent → gateway split and decide whether a trace-ID-aware loadbalancing tier is required in front of the gateway. State explicitly which gateway work is stateful (sampling, spanmetrics) and therefore sensitive to how spans are routed. 2. **Load distribution** — specify the loadbalancing exporter (routing key: `traceID` for sampling, `service` or `resource` where appropriate), its resolver (`dns`, `k8s`, or `static`), and how it reacts to replicas joining/leaving. 3. **Autoscaling** — recommend the scaling signal (CPU is usually wrong for I/O-bound Collectors; prefer `otelcol_receiver_accepted_*` rate, queue depth, or memory) and give an HPA/KEDA spec with sane min/max, stabilization windows, and headroom for spikes. 4. **Zero-loss upgrades** — define `terminationGracePeriodSeconds`, a preStop drain, `sending_queue` with `file_storage` persistence, and `maxUnavailable`/`maxSurge` so a rolling upgrade or scale-down drains in-flight data instead of dropping it. 5. **Resilience** — add health_check (readiness gated on pipeline readiness), pprof, zpages, PodDisruptionBudget, and topology spread / anti-affinity so a node loss never takes the whole tier. 6. **Backpressure** — align `memory_limiter`, `sending_queue` depth, `retry_on_failure`, and downstream backend rate limits so pressure propagates cleanly to producers rather than causing silent loss or OOM. 7. **Capacity math** — size replicas, requests/limits, and queue depth against the ingest numbers I gave, and state the cost/headroom trade-off. Output as: (a) annotated gateway Collector YAML (plus the LB tier if needed), (b) the HPA/KEDA + PDB + rollout manifests, (c) a capacity/sizing table, (d) a rolling-upgrade drain runbook, (e) the SLIs/alerts that prove the tier is healthy (accepted vs refused vs dropped, queue depth, RSS). Call out any place where scaling would split traces across replicas and corrupt sampling or spanmetrics, and how the loadbalancing tier prevents it.
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
-
OpenTelemetry Collector Pipeline Design Prompt
Design a production OpenTelemetry Collector configuration with well-ordered receiver, processor, and exporter pipelines for traces, metrics, and logs, tuned for reliability and backpressure.
-
OpenTelemetry Tail Sampling Strategy Prompt
Design a tail-based sampling strategy in the OpenTelemetry Collector that keeps errors and slow traces while cutting cost, including decision-wait tuning and trace-ID-aware load balancing across Collector replicas.
-
OpenTelemetry Collector Kubernetes Deployment Prompt
Design a Kubernetes deployment topology for the OpenTelemetry Collector using the Operator: choose agent DaemonSet plus gateway Deployment, size resources, wire the target allocator for Prometheus scraping, and set up rollout without dropping telemetry.
-
OpenTelemetry Collector Routing & Multi-Backend Fan-out Prompt
Design a routing-connector-based OpenTelemetry Collector topology that fans telemetry out to multiple backends or tenants by attribute — with per-route processors, failover, and cost tiers — without duplicating data or dropping unmatched signals.
More OpenTelemetry prompts & error guides
Browse every OpenTelemetry 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.