aks-troubleshooting
Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation. WHEN: pod crashes or Pending, CrashLoopBackOff, OOMKilled, ImagePullBackOff, node NotReady, DNS or ingress failure, connectivity timeout, network policy, SNAT exhaustion, node-pool scaling blocked by QuotaExceeded or InsufficientVCPUQuota, upgrade stuck, spot or zone disruption, a bare VMExtensionProvisioningError or AllocationFailed wrapper, an uncataloged capacity symptom, or 'investigate my AKS cluster'. DO NOT USE FOR: packet capture (use aks-network-capture); GPU or model-serving issues (use aks-gpu-inference); cluster creation or provisioning (use azure-kubernetes); cost (use cost-analysis from the optional azure-cost plugin); pod rightsizing (use azure-kubernetes); a fully qualified documented AKS signature with every required nested qualifier (use aks-known-issues); standalone failures on non-AKS Azure resources (use azure-diagnostics). Unqualified errors and open-ended incidents stay here only for AKS.
- Version
- 0.0.0-placeholder
- License
- MIT
Pinned to revision 90929a087ad5, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/aks-troubleshooting/SKILL.md
- skills/aks-troubleshooting/general-diagnostics.md
- skills/aks-troubleshooting/load-balancer-and-ingress.md
- skills/aks-troubleshooting/network-policy.md
- skills/aks-troubleshooting/networking.md
- skills/aks-troubleshooting/node-issues.md
- skills/aks-troubleshooting/pod-failures.md
- skills/aks-troubleshooting/references/api-server-webhooks-tunnel.md
- skills/aks-troubleshooting/references/auto-upgrade-evidence.md
- skills/aks-troubleshooting/references/azure-mcp.md
- skills/aks-troubleshooting/references/azure-network-path.md
- skills/aks-troubleshooting/references/command-flows.md
- skills/aks-troubleshooting/references/inspektor-gadget.md
- skills/aks-troubleshooting/references/report-template.md
- skills/aks-troubleshooting/references/structured-input-modes.md
- skills/aks-troubleshooting/references/symptom-map.md
- skills/aks-troubleshooting/scripts/cluster-snapshot.sh
- skills/aks-troubleshooting/scripts/pod-deep-dive.sh
- skills/aks-troubleshooting/spot-and-zone-issues.md
- skills/aks-troubleshooting/upgrade-operations.md
- skills/aks-troubleshooting/version.json
Every link opens the file at its source, pinned to the revision this page describes.