SkillVaultskills Browse all 500 skills

Infrastructure · Version 1.3.0 · Reviewed 2026-08-02

Envoy Proxy Debugger

Review and harden xDS configuration diagnosis and upstream reset analysis with evidence, explicit trade-offs, and a verification plan.

4 method steps 4 documented failure modes 4 diagnostic checks 7 quality gates

Explains Envoy clusters, listeners, routes, filters, outlier ejection, retries, circuit breakers, and xDS configuration failures.

₹99 one-time

Get this skill archive

What this skill helps you do

  • xDS configuration diagnosis
  • Upstream reset analysis
  • Retry and outlier review

How Envoy Proxy Debugger works

You provide

Manifests, plans, and current runtime topology

It inspects

Reversibility and blast radius for xDS configuration diagnosis

It decides

A upstream reset analysis change staged by risk

You verify

Platform-native health check after each stage

What it checks first

Envoy Proxy Debugger explains Envoy clusters, listeners, routes, filters, outlier ejection, retries, circuit breakers, and xDS configuration failures. Use it when the work involves xDS configuration diagnosis, Upstream reset analysis, Retry and outlier review.

  1. Whether a change is reversible, and specifically whether it replaces or mutates a stateful resource.
  2. Blast radius: the number of environments, regions, and workloads a change touches at once.
  3. Identity and permission scope of the executing principal.
  4. Drift between declared and actual state.

Failure modes it recognizes

  • An immutable-attribute change forcing replacement of a stateful resource.
  • A change applied to all environments simultaneously with no canary.
  • Over-broad permissions granted to make a deployment succeed and never narrowed.
  • Manual changes creating drift that the next apply silently reverts.

Answers it will reject

  • Approving a plan from summary counts rather than reading the replacement lines.
  • Suppressing drift detection to silence noise, which disables reconciliation.
  • Granting administrative rights as a debugging shortcut.

Decision rules it applies

  • Any stateful replacement requires a tested backup and restore path before approval.
  • Roll out by blast radius: one non-critical target, then one zone, then the fleet.
  • Grant the narrowest permission that completes the task, with an expiry.

Evidence it asks for

  • Diff the plan in machine-readable form and classify every action.
  • Verify the rollback path by executing it in a non-production environment.
  • Confirm post-change health with a platform-native check, not an assumption.

The method inside

  1. Reconstruct the symptom timeline and define what healthy behavior would look like for xDS configuration diagnosis.
  2. Rank hypotheses for upstream reset analysis by evidence, blast radius, and ability to explain every observed symptom.
  3. Run the cheapest discriminating check for retry and outlier review; update confidence only when evidence changes.
  4. Separate immediate stabilization, confirmed cause, contributing conditions, and prevention; finish with a reproducible verification.

Deliverables

  • xDS configuration diagnosis assessment
  • Upstream reset analysis decision and action plan
  • Retry and outlier review verification checklist

Evidence requirements

  • Infrastructure code or configuration
  • Runtime topology and environment constraints
  • Plan, events, policies, and failure symptoms

Quality gates

  • Every material claim traces to supplied evidence or is labeled as a hypothesis.
  • The response follows the declared deliverable contract.
  • No execution, access, measurement, or verification is invented.
  • Secrets and personal data are redacted rather than repeated.
  • The user receives a concrete independent verification step.
  • The relevant failure modes in this domain were considered rather than only the reported symptom.
  • No listed anti-pattern was recommended as a solution.

Example task

Input

Envoy returns upstream_reset_before_response_started even though the application logs show no incoming request.

Expected output

The reset occurs before the HTTP request reaches the app: the upstream TLS context expects a different SNI than the cluster sends. Inspect transport socket match and host rewrite rather than application handlers...

Boundaries and compatibility

Ideal for

  • xDS configuration diagnosis: produce a decision or artifact grounded in supplied evidence.
  • Upstream reset analysis: produce a decision or artifact grounded in supplied evidence.
  • Retry and outlier review: produce a decision or artifact grounded in supplied evidence.

Out of scope

  • Applying infrastructure changes without approval
  • Assuming cloud access or live resource visibility

Agent compatibility

  • GitHub Copilot custom agents
  • Claude Agent Skills / SKILL.md
  • Any instruction-following chat model

Tool policy: Advisory by default. No tools are assumed. If the host provides tools, use read-only evidence gathering unless the user explicitly approves a scoped write or execution action.