---
title: "Microsoft Azure Diagnostics: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-azure-diagnostics/
description: "Routes Azure incidents through resource health, recent changes, logs and service-specific troubleshooting guides."
---

# Microsoft Azure Diagnostics: review, setup & limitations · Undominated.ai

> Routes Azure incidents through resource health, recent changes, logs and service-specific troubleshooting guides.

[← Explore all skills](/skills/)

CLOUD OPERATIONS / Microsoft

# Microsoft Azure Diagnostics

Routes Azure incidents through resource health, recent changes, logs and service-specific troubleshooting guides.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 9 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/LICENSE)
 Revision fc164ba1d7a0
 [Read what was—and wasn’t—checked ↓](#review)

“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 CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.”

 [Microsoft · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Separates Container Apps, App Service, Functions, AKS, compute and messaging investigations, each routed to its own reference.
- Includes a readable AKS baseline script and KQL examples that make the initial evidence collection inspectable.
- Rule 2 makes supplied evidence the starting point: when the user asks for evidence-only analysis or prohibits live Azure access, the skill says not to query or modify Azure.

### A good fit for

 - Collecting context for an Azure production incident
- Investigating unhealthy AKS workloads before remediation
- Diagnosing from logs, metrics and a timeline you supply, without live Azure access
- Continue baseline AKS diagnostics when the optional aks-skills add-on is absent, declined or unsupported by the host.

### Weigh up before choosing

 - The AKS helper selects Azure resources by arguments but uses the existing kubectl context; confirm both point to the same cluster.
- The helper continues after collection failures, so a completed digest does not mean every check succeeded.
- Diagnostic logs can contain sensitive application data, and broader remediation can change production resources.
- The repository README says the azure plugin is copied from microsoft/github-copilot-for-azure and changed there. This review read the microsoft/skills copy only.
- The skill directory holds 12 helper scripts (six shell, six PowerShell), so this catalogue offers no download. Install the complete directory.

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 (version 1.2.11)
- .github/plugins/azure-skills/skills/azure-diagnostics/scripts/aks-baseline.sh
- .github/plugins/azure-skills/skills/azure-diagnostics/references/kql-queries.md
- README.md (Quick Start, Plugins, Contributing note and License)
- .github/plugins/azure-skills/LICENSE (MIT, Copyright 2025 Microsoft Corporation)
- LICENSE (repository root, MIT, Copyright Microsoft Corporation)

### 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.
- Rule 7 prefers the bundled diagnostic scripts for permitted live collection when identifiers are known, and says not to run them when supplied evidence suffices or live access is prohibited.
- Rule 9 keeps the baseline AKS diagnostics available when the optional aks-skills add-on is absent, declined or unsupported by the host.
- The azure-skills plugin directory carries its own MIT licence (Copyright 2025 Microsoft Corporation), the nearest licence to the skill. The repository root LICENSE is also MIT.
- Re-pinned from 96bbd0043d58468fe02090a1691a138e1ef0182b to fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb: SKILL.md moved from version 1.2.6 to 1.2.11, adding rules 2, 7 and 9 and new trigger phrases. Nine reference or troubleshooting files changed and three were added (references/functions/durable.md, references/functions/triggers.md, troubleshooting/aks/optional-aks-operations.md). The 12 scripts, including aks-baseline.sh, and references/kql-queries.md are unchanged.

### Not established by this review

 - Source inspection only; no skill installation or workflow execution was performed.
- None of the 12 bundled scripts was run, and no Azure or AKS resource was queried.
- 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.

[Upstream setup instructions ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md)

DOCUMENTED COMMAND

 npx skills add microsoft/skills/.github/plugins/azure-skills/skills/azure-diagnostics Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

 npx skills add https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics Copy reviewed-revision command ↗ - Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
- Choose your AI tools and project or global 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

### Compatibility

Azure CLI and optional Azure MCP · kubectl for the AKS baseline path

### Read cloud configuration, activity, metrics and logs

 - Read cloud configuration, activity, metrics and logs
- Read cluster-wide workload state through the active kubectl context
- Remediation paths require authorization beyond baseline collection

### Cost model

The instructions are MIT-licensed; Azure logging/query services, affected resources and agent access have their own billing.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Skill definition at reviewed revision ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
- [Reviewed reference or helper: scripts/aks-baseline.sh ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/scripts/aks-baseline.sh) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/scripts/aks-baseline.sh Supports: review, limitations, access
- [Reviewed reference or helper: references/kql-queries.md ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/references/kql-queries.md) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/references/kql-queries.md Supports: review, limitations, access
- [Plugin licence, nearest to the skill ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/LICENSE) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/LICENSE Supports: license, review
- [Repository root licence ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: license
- [Publisher installation and project documentation ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-13 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: install, compatibility, access, limitations
- [Skills installer source formats and selective installation ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) Checked 2026-10-13 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install
- [Installer implementation: full commit SHA fallback ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts) Checked 2026-10-13 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts Supports: install
- [Pinned source sections reviewed in continuation W13 on 2026-10-15 ↗](https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-skills/skills/azure-diagnostics/SKILL.md Supports: upstreamDescription, bestFor, review.notTested

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### AKS Automatic Readiness ↗ Pins Microsoft's AKS Automatic readiness skill, which assesses a cluster or local manifests without changing the cluster and writes files only after an accepted diff.](/skills/microsoft-azure-kubernetes-automatic-readiness/)[### Azure Kubernetes ↗ Pins Microsoft's AKS cluster skill, which refuses to print secrets or subscription identifiers and sends application deployment to a different skill.](/skills/microsoft-azure-kubernetes/)[### Deploy to AKS ↗ Pins Microsoft's skill for deploying an existing web app to a running AKS cluster, which requires az login and refuses to provision the cluster.](/skills/microsoft-azure-kubernetes-app-deploy/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
