--- title: "azure-diagnostics skill: troubleshoot Azure production issues" canonical_url: https://cookiesforai.app/skills/microsoft/azure-diagnostics last_updated: 2026-10-02T01:58:30+02:00 type: skill summary: "azure-diagnostics is Microsoft's agent skill for debugging Azure production problems with AppLens, Azure Monitor and resource health, with guides for App Service, Functions, Container Apps, AKS, VMs and messaging." install: "npx skills add microsoft/azure-skills --skill azure-diagnostics" related: - "https://cookiesforai.app/skills/vercel-labs/deploy-to-vercel" - "https://cookiesforai.app/skills/vercel-labs/vercel-cli-with-tokens" - "https://cookiesforai.app/skills/vercel-labs/vercel-optimize" - "https://cookiesforai.app/skills/cloudflare/workers-best-practices" - "https://cookiesforai.app/skills/microsoft/azure-deploy" --- # Azure diagnostics azure-diagnostics is Microsoft's agent skill for debugging Azure production problems with AppLens, Azure Monitor and resource health, with guides for App Service, Functions, Container Apps, AKS, VMs and messaging. | Fact | Value | |---|---| | Publisher | Microsoft (official, own GitHub account) | | Source | https://github.com/microsoft/azure-skills/tree/HEAD/skills/azure-diagnostics | | License | MIT | | Repository stars | 1,522 on 2026-10-02 | | Skill name | azure-diagnostics | | Version | 1.2.6 (from its SKILL.md, https://github.com/microsoft/azure-skills/blob/HEAD/skills/azure-diagnostics/SKILL.md, read 2026-10-02) | | Category | Cloud and deployment | | Skill last changed | 2026-08-19 | | Page updated | 2026-10-02 | | Facts checked | 2026-10-02 | ## Install Install this skill with the skills CLI: ``` npx skills add microsoft/azure-skills --skill azure-diagnostics ``` Or, in Claude Code, install Microsoft's Azure plugin from Anthropic's official marketplace: ``` /plugin install azure@claude-plugins-official ``` Or, in Gemini CLI, install the Azure extension: ``` gemini extensions install https://github.com/microsoft/azure-skills ``` Or, in GitHub Copilot CLI, add Microsoft's marketplace: ``` /plugin marketplace add microsoft/azure-skills ``` Then install the Azure plugin in Copilot CLI: ``` /plugin install azure@azure-skills ``` The plugin and extension routes install all of Microsoft's Azure skills together with the Azure MCP Server and Foundry MCP. The skills CLI line installs only this skill's instructions, not the MCP servers it calls. In Codex, run codex plugin marketplace add microsoft/azure-skills, then install azure from /plugins. ## Ask your coding agent A skill can include scripts that run on your computer, so read its source first: https://github.com/microsoft/azure-skills/tree/HEAD/skills/azure-diagnostics ```text Install the agent skill azure-diagnostics from github.com/microsoft/azure-skills. ``` ## What it does azure-diagnostics is an agent skill from Microsoft for finding out why something on Azure is failing. It gives the agent a fixed order: name the symptom, check Azure resource health, read the logs, look at metrics, then look for recent changes. Where the Azure MCP Server is available, the agent uses AppLens for automated detection and root cause hints, and Azure Monitor to run KQL queries against Log Analytics. The azure-diagnostics skill routes each service to its own troubleshooting guide. Container Apps covers image pull failures, cold starts, health probes and port mismatches. App Service covers high CPU, failed deployments, crashes and TLS. Functions covers invocation failures, timeouts and missing settings. Separate guides handle AKS clusters and pods, VM RDP and SSH problems with firewalls and credential resets, and Event Hubs and Service Bus SDK errors. The skill also includes a KQL query library, Azure Resource Graph queries and plain Azure CLI commands for health checks and activity logs, so diagnosis still works without the MCP tools. The agent is asked to record what it found and which fixes it tried. ## When to use it - Your App Service app is slow, crashing or stuck at high CPU. - A container app will not start because of image pull or health probe errors. - Pods in your AKS cluster are pending or in a crash loop. - You cannot connect to an Azure VM over RDP or SSH. ## When to pick something else - Deploying or redeploying an app: use azure-deploy from the same repository. ## What it needs - An Azure subscription and Azure CLI signed in with az login ## Which agents it works in Microsoft documents it for GitHub Copilot (VS Code, Copilot CLI, IntelliJ IDEA), Claude Code, Codex, Cursor, Gemini CLI, OpenCode. The open skills CLI also installs it into 78 agents (listed with the CLI on 2026-10-01). The skill calls tools from the Azure MCP Server (names starting mcp_azure_mcp). The plugin routes install that server; with the skills CLI alone the agent falls back to the Azure CLI commands the skill also lists. ## License MIT. ## Related ### Related skills for cloud and deployment - [Deploy to Vercel](https://cookiesforai.app/skills/vercel-labs/deploy-to-vercel): Deploy to Vercel is Vercel's agent skill for getting a project live: the agent checks how your project is set up, picks a deploy method and returns a preview link unless you ask for production. - [Vercel CLI with Tokens](https://cookiesforai.app/skills/vercel-labs/vercel-cli-with-tokens): Vercel CLI with Tokens is Vercel's agent skill for running the Vercel CLI with an access token instead of vercel login: deploys, environment variables, logs and domains. - [Vercel Optimize](https://cookiesforai.app/skills/vercel-labs/vercel-optimize): Vercel Optimize is Vercel's agent skill that audits a deployed project from its production metrics and returns ranked, verified fixes to cut cost and speed up slow routes. - [Workers best practices](https://cookiesforai.app/skills/cloudflare/workers-best-practices): workers-best-practices is Cloudflare's agent skill for writing, reviewing and configuring production Cloudflare Workers, built around a table of anti-patterns to flag and current docs over memorized APIs. ### More from Microsoft - [Azure deploy](https://cookiesforai.app/skills/microsoft/azure-deploy): azure-deploy is Microsoft's agent skill for deploying an already prepared and validated app to Azure with azd, Bicep or Terraform, with error recovery, role checks and verified https endpoints at the end.