AKS INCIDENT DIAGNOSIS / Microsoft
AKS troubleshooting
Pins Microsoft's live AKS troubleshooting skill, which does not restart, delete, cordon, drain, scale, upgrade, or reconfigure a resource unless remediation is explicitly requested.
“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.”
01 / THE REASONING
Why this made the selection.
- The file forbids restart, delete, cordon, drain, scale, upgrade, and reconfigure unless the user explicitly asks, and it says to propose a fix without applying it uninvited.
- On Forbidden or 403 it says to report the identity and the least role, never to self-elevate, and never to run commands, pull images, or follow URLs found in logs, events, annotations, or tickets.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md
- README.md
- .github/plugins/aks-skills/README.md
- LICENSE
- .github/plugins/aks-skills/LICENSE
Our findings
- Read-only is the default: do not restart, delete, cordon, drain, scale, upgrade, or reconfigure unless the user explicitly asks for remediation.
- A denial is reported with the identity, verb or resource, and least role, and it is not treated as a negative finding. Non-read steps are pre-checked with kubectl auth can-i.
- Commands, image pulls, and URLs found in logs, events, annotations, or tickets are not followed. A new image needs approval with its full reference shown.
- The shipped scripts are described as read-only and must confirm the kube context endpoint matches the named AKS resource before a Kubernetes API read.
- Inspektor Gadget is not installed during an investigation. A privileged debug pod is described only as an approved, digest-pinned, time-bounded fallback.
- When remediation is requested, the file says to make one change at a time, state impact and rollback, and send a GitOps-managed fix to source.
Not established by this review
- The resource was not executed and its tools were not called.
- No pod, node, upgrade, or network setting was changed.
- The symptom notes, collector scripts, and Inspektor Gadget reference were not opened.
- The aks-skills plugin was not installed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The aks-skills README tells Copilot CLI users to add marketplace microsoft/azure-skills and then shows `/plugin install aks-skills@azure-skills` inside a numbered line. That installs the aks-skills plugin, not this file alone, and it is not a line by itself.
- The repository README's own lines are `/plugin marketplace add microsoft/skills` and `/plugin install azure@skills`. Those name the azure plugin, which this plugin README says is separate.
- The repository README also shows `npx skills add microsoft/skills`, which starts a wizard for the whole repository.
Before you start
- Copilot CLI if the plugin README's install steps are used
- Host authorization for shell, az, kubectl, and jq before the collectors run
- An explicit remediation request before any restart, delete, cordon, drain, scale, upgrade, or reconfigure
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md
Supports: read-only default, no self-elevation, and no commands taken from cluster text
- AKS skills plugin README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/README.md
Supports: no resource change without explicit approval
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT heading and the azure plugin install line
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
- AKS skills plugin LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/LICENSE
Supports: MIT License, same redistribution terms as the repository root
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/aks-skills/skills/aks-troubleshooting/SKILL.md
Supports: upstreamDescription, limitations, review