azure-troubleshooting

name	azure-troubleshooting
description	Azure resource troubleshooting patterns including KQL templates, metric thresholds, health checks, and remediation playbooks. Use when diagnosing unhealthy Azure resources or building diagnostic workflows.
compatibility	Requires Azure CLI with resource-graph extension

Azure Troubleshooting Skill

Structured diagnostic patterns for Azure resource health assessment and remediation. Load the specific reference file when you need detailed queries, health-check tables, or playbook steps.

Reference Files (Load on Demand)

File	When to Load
references/kql-templates.md	Need KQL queries for resource discovery, error search, or metrics
references/health-checks.md	Diagnosing a specific resource type (App Service, VM, Storage, SQL, Static Web Apps)
references/remediation-playbooks.md	Fixing a known issue (high CPU, throttling, DTU exhaustion) + report template

---

Quick Reference

Capability	Description
Resource Discovery	Azure Resource Graph queries to find and inventory resources
Health Checks	Per-resource-type diagnostic commands and metric thresholds
KQL Templates	Log Analytics queries for common failure scenarios
Severity Classification	Standardised impact/urgency mapping for findings
Remediation Playbooks	Step-by-step resolution for common issues

---

Severity Classification

Classify every finding with consistent severity:

Severity	Criteria	Response Time
Critical	Service down, data loss risk, security breach	Immediate
High	Degraded performance, failing redundancy, auth issues	Within 4 hours
Medium	Suboptimal configuration, missing best practices, capacity warnings	Within 24 hours
Low	Cosmetic issues, documentation gaps, minor optimisations	Next sprint

---

Diagnostic Workflow

Follow this six-phase sequence for any resource investigation:

Phase	Action	Tool
1. Discovery	Get resource details via az resource show	CLI
2. Health Assessment	Run resource-type health checks	Load references/health-checks.md
3. Log Analysis	Query Log Analytics for errors/warnings	Load references/kql-templates.md
4. Activity Log	Review recent failed operations	Load references/kql-templates.md
5. Classification	Rate each finding by severity table above	This file
6. Report	Generate structured diagnostic report	Load references/remediation-playbooks.md

Phase 1 — Discovery (Always Start Here)

az resource show --ids "$resourceId" \
  --query "{name:name, type:type, location:location, sku:sku, tags:tags}"

Then load the appropriate reference file for phases 2-6.

---

Supported Resource Types

Resource Type	Health Check Reference	Common Issues
App Service / Web Apps	references/health-checks.md	HTTP 5xx, high CPU/memory
Virtual Machines	references/health-checks.md	CPU spikes, disk latency
Storage Accounts	references/health-checks.md	Throttling, availability drops
SQL Database	references/health-checks.md	DTU exhaustion, deadlocks
Static Web Apps	references/health-checks.md	Deployment failures, SSL

---

Learn More

For issues not covered here, query official documentation:

Topic	How to Find
Service-specific limits	microsoft_docs_search(query="{service} limits quotas")
KQL reference	microsoft_docs_search(query="KQL quick reference Azure Monitor")
Metric definitions	microsoft_docs_search(query="{service} supported metrics Azure Monitor")
Troubleshooting guides	microsoft_docs_search(query="{service} troubleshoot common issues")