StealIt

Azure Diagnostics

azure-diagnostics

Debug Azure production issues using AppLens, Azure Monitor, resource health, and safe triage, including evidence-only diagnosis without live access. 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.

Install

Run this in your project folder. It works with Claude Code, Cursor, Codex and dozens of other agents.

$ npx skills add microsoft/azure-skills --skill azure-diagnostics

Needs Node.js. Add -g to install for every project, or -a claude-code to skip the agent picker.

How to use Azure Diagnostics

Once it's installed, Claude reads this skill on its own whenever a request matches what it's for, so you don't have to mention it by name. In Claude Code you can also run it directly by typing /azure-diagnostics.

It includes scripts that Claude may run on your computer, so skim them on GitHub before you install.

What the instructions cover

  1. 1Triggers
  2. 2Rules
  3. 3Quick Diagnosis Flow
  4. 4Troubleshooting Guides by Service
  5. 5Routing
  6. 6Quick Reference
  7. 7Check Azure Resource Health
  8. 8References

Section headings from the skill's SKILL.md file.

What's inside · 54 files

  • SKILL.md
  • references/app-service/README.md
  • references/azure-resource-graph.md
  • references/container-apps/README.md
  • references/functions/README.md
  • references/functions/durable.md
  • references/functions/triggers.md
  • references/kql-queries.md
  • scripts/aks-baseline.ps1
  • scripts/aks-baseline.sh
  • scripts/appservice-diagnostics.ps1
  • scripts/appservice-diagnostics.sh
  • scripts/containerapp-diagnostics.ps1
  • scripts/containerapp-diagnostics.sh
  • scripts/pod-evidence.ps1
  • scripts/pod-evidence.sh
  • scripts/run-ig.ps1
  • scripts/run-ig.sh
  • scripts/test-messaging-connectivity.ps1
  • scripts/test-messaging-connectivity.sh
  • troubleshooting/aks/aks-troubleshooting.md
  • troubleshooting/aks/general-diagnostics.md
  • troubleshooting/aks/load-balancer-and-ingress.md
  • troubleshooting/aks/network-policy.md
  • troubleshooting/aks/networking.md
  • troubleshooting/aks/node-issues.md
  • troubleshooting/aks/optional-aks-operations.md
  • troubleshooting/aks/pod-failures.md
  • troubleshooting/aks/references/aks-mcp.md
  • troubleshooting/aks/references/command-flows.md
  • troubleshooting/aks/references/inspektor-gadget.md
  • troubleshooting/aks/references/structured-input-modes.md
  • troubleshooting/aks/spot-and-zone-issues.md
  • troubleshooting/aks/upgrade-operations.md
  • troubleshooting/compute/references/cannot-connect-to-vm.md
  • troubleshooting/compute/references/credential-auth-errors.md
  • troubleshooting/compute/references/firewall-blocking.md
  • troubleshooting/compute/references/network-connectivity.md
  • troubleshooting/compute/references/rdp-connectivity.md
  • troubleshooting/compute/references/rdp-service-config.md
  • + 14 more files on GitHub →

More from Microsoft

See all →

Airunway AKS Setup

Set up AI Runway on AKS — from bare cluster to running model. Covers cluster verification, controller install, GPU assessment, provider setup, and first deployment. WHEN: "setup…

Cloud & DevOpsMicrosoft1.6k

Appinsights Instrumentation

Guidance for instrumenting webapps with Azure Application Insights. Provides telemetry patterns, SDK setup, and configuration references. WHEN: how to instrument app, App Insights…

Cloud & DevOpsMicrosoft1.6k

Azure AI

Build and troubleshoot Azure AI Search, Speech, OpenAI, and Document Intelligence apps. WHEN: AI Search, query search, vector search, hybrid search, semantic search…

AI & AgentsMicrosoft1.6k

Azure Aigateway

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP…

Cloud & DevOpsMicrosoft1.6k
See all →

Deploy To Vercel

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a…

Cloud & DevOpsVercel34k

Vercel CLI With Tokens

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to…

Cloud & DevOpsVercel34k

Vercel Optimize

Use for Vercel cost and performance optimization on deployed projects, especially Next.js, SvelteKit, Nuxt, and limited Astro apps. Collect Vercel metrics, usage, project config…

Cloud & DevOpsVercel34k

Connectivity Triage

Use this skill when debugging active macOS connectivity failures, when an API or MCP service times out or disconnects, when DNS resolution is failing or inconsistent, or when…

Cloud & DevOpsSeth Hobson42k