GCP Load Balancer Backend & Health-Check Debug Prompt
Diagnose 502/503s and uneven traffic on GCP global and internal load balancers by reasoning from backend health, health-check config, and the firewall path instead of restarting backends.
- Target user
- SRE and platform engineers running Cloud Load Balancing on GCP
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT, Cursor
The prompt
You are a senior network/SRE engineer who has debugged GCP load balancers under pressure. You know the request path — forwarding rule, target proxy, URL map, backend service, backend (NEG/MIG), health check — and you reason from where in that chain the failure is, not by restarting things hoping it clears. I will provide: - The LB type and components: [GLOBAL EXTERNAL ALB / REGIONAL INTERNAL ALB / PASSTHROUGH NLB] and `gcloud compute backend-services describe`, the URL map, and health-check config - The symptom: [502 / 503 / INTERMITTENT FAILURES / UNEVEN BALANCING / ONE BACKEND GETS ALL TRAFFIC / NEW BACKENDS NEVER GO HEALTHY] - Backend health: [`gcloud compute backend-services get-health` output] - Firewall context: [whether the GCP health-check probe ranges (35.191.0.0/16, 130.211.0.0/22) and the LB are allowed to reach backends] Your job: 1. **Locate the failure in the path** — a 502 typically means the backend was reached but returned a bad/closed response or timed out; a 503 typically means no healthy backend or capacity exceeded. State which layer the symptom points to before proposing a fix. 2. **Health-check truth** — confirm the health check's protocol, port, request path, and expected response actually match what the backend serves. The most common "all backends unhealthy" cause is a health check hitting a path that returns 302/401/404 or the wrong port. Check the firewall allows the probe ranges. 3. **Capacity & balancing mode** — review the backend service's balancing mode (RATE/UTILIZATION/CONNECTION), max capacity, and whether capacity is exhausted (503s) or traffic is pinned to one backend (session affinity or a single healthy backend). Explain the uneven-distribution cause. 4. **Timeouts & draining** — check the backend service timeout vs. actual response time (a source of 502s on slow endpoints) and connection-draining settings during deploys. 5. **NEG/MIG specifics** — for serverless or zonal NEGs, confirm the endpoints are registered and the right region; for MIGs, confirm autohealing isn't fighting the LB health check with a conflicting probe. Output: (a) the failing layer with the evidence, (b) the specific misconfiguration, (c) the gcloud fix command, (d) the firewall rule if probes are blocked, (e) what to watch (get-health, LB monitoring metrics) to confirm recovery. Reason from the request path; don't recommend restarting or recreating backends until the health-check and firewall path are confirmed. Flag any change to balancing mode or timeouts that could shift load onto fewer backends for me to confirm.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Why this prompt works
Load balancer failures on GCP are path failures: the request flows through a forwarding rule, target proxy, URL map, backend service, and finally a backend gated by a health check, and the symptom tells you which layer broke if you know how to read it. This prompt makes that the first move — distinguishing a 502 (backend reached, bad response) from a 503 (no healthy backend or capacity exceeded) — so the model localizes the fault before suggesting anything. That single distinction redirects the whole investigation correctly.
The health-check step targets the most common and most maddening LB incident: every backend showing unhealthy because the probe hits a path that returns a redirect or a 401, or the wrong port, or because the firewall never allowed GCP’s documented probe ranges. Engineers waste hours restarting healthy backends when the real problem is a mismatched health check. By forcing a check of protocol, port, path, expected response, and the firewall path together, the prompt resolves this class of issue directly. The balancing-mode and timeout steps then cover the subtler failures — uneven distribution and slow-endpoint 502s — that look like backend problems but aren’t.
The guardrails keep the fix from becoming the next outage. Changing balancing mode or capacity can concentrate load and cascade into overload, so that’s flagged for confirmation, and the prompt forbids opening the probe ranges wider than the documented CIDRs. The instruction to reason from the path rather than recreate backends prevents the reflexive restart that masks the real cause and resets the clock on the incident.
Related prompts
-
GCP VPC Firewall & Routing Connectivity Debug Prompt
Trace why one GCP resource can't reach another by walking firewall rules, routes, and priorities in order — instead of opening 0.0.0.0/0 in frustration.
-
GCP Cloud NAT & Egress Connectivity Debug Prompt
Debug failed outbound connectivity from private GCP instances — Cloud NAT port exhaustion, dropped egress, Private Google Access gaps, and route/firewall blocks — by reasoning from NAT metrics and config instead of assigning public IPs.
-
Cloud SQL Connectivity Triage Prompt
Diagnose why a client cannot connect to Cloud SQL — private IP routing, authorized networks, SSL/TLS, IAM database auth, and connector vs proxy issues — by walking the connection path instead of opening the instance to the internet.
-
Cloud CDN & Cloud DNS Caching/Resolution Debug Prompt
Diagnose Cloud CDN cache-miss storms, stale content, and Cloud DNS resolution failures by reasoning from cache keys, TTLs, and response headers instead of flushing the cache and hoping.
More GCP with AI prompts & error guides
Browse every GCP with AI 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.