CLOUD OPERATIONS / Microsoft
Microsoft Azure Diagnostics
Routes Azure incidents through resource health, recent changes, logs and service-specific troubleshooting guides.
“Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high”
01 / THE REASONING
Why this made the selection.
- Separates App Service, Functions, AKS, compute and messaging investigations.
- Includes a readable AKS baseline script and KQL examples that make the initial evidence collection inspectable.
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/azure-skills/skills/azure-diagnostics/SKILL.md
- .github/plugins/azure-skills/skills/azure-diagnostics/scripts/aks-baseline.sh
- .github/plugins/azure-skills/skills/azure-diagnostics/references/kql-queries.md
- LICENSE
Our findings
- The inspected AKS script issues read commands and prints failed collection steps rather than terminating the sweep.
- Its pod filter considers readiness, restart counts and terminal job states, not just the pod phase.
- The KQL reference uses bounded time windows and assumes the relevant telemetry tables exist.
Not established by this review
- Source inspection only; no skill installation or workflow execution was performed.
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.
DOCUMENTED COMMAND
npx skills add https://github.com/microsoft/skills/tree/96bbd0043d58468fe02090a1691a138e1ef0182b/.github/plugins/azure-skills/skills/azure-diagnosticsCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
- Choose the intended agent and project scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- Azure resource/log permissions
- Correct Kubernetes context and enabled diagnostic settings where relevant
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/96bbd0043d58468fe02090a1691a138e1ef0182b/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
https://github.com/microsoft/skills/blob/96bbd0043d58468fe02090a1691a138e1ef0182b/.github/plugins/azure-skills/skills/azure-diagnostics/scripts/aks-baseline.sh
Supports: review, limitations, access
https://github.com/microsoft/skills/blob/96bbd0043d58468fe02090a1691a138e1ef0182b/.github/plugins/azure-skills/skills/azure-diagnostics/references/kql-queries.md
Supports: review, limitations, access
https://github.com/microsoft/skills/blob/96bbd0043d58468fe02090a1691a138e1ef0182b/LICENSE
Supports: license
https://github.com/microsoft/skills/blob/96bbd0043d58468fe02090a1691a138e1ef0182b/README.md
Supports: install, compatibility, access
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts
Supports: install