azure-resource-health-diagnose

Diagnose Azure resource failures using logs, metrics, and telemetry to produce a prioritized remediation plan.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-resource-health-diagnose-serpro-workshop-fortaleza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-resource-health-diagnose
Source: https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula/tree/main/.github/skills/azure-resource-health-diagnose
Command: npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-resource-health-diagnose-serpro-workshop-fortaleza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an Azure resource fails, degrades, or gets throttled, finding the root cause across logs, metrics, and telemetry is slow and error-prone. This Skill guides a structured investigation of a specific deployed Azure resource and produces a severity-classified diagnosis with a phased remediation plan. ## Core Features & Use Cases - Resource discovery and health assessment: Locates the resource across subscriptions, detects its type (Web Apps, VMs, Cosmos DB, Storage, SQL, Functions, and more), and evaluates provisioning state, availability, and utilization. - Log and telemetry analysis: Runs targeted KQL queries against Log Analytics and Application Insights to find error patterns, performance degradation, and dependency failures. - Root cause classification and remediation plan: Classifies issues by severity (Critical/High/Medium/Low), identifies root cause categories, and generates a phased fix plan with Azure CLI commands, validation steps, and rollback guidance. - Use Case: Your App Service starts returning HTTP 500 errors after a deployment. The Skill locates the app, queries the last 24 hours of logs, correlates the errors with the deployment, and proposes immediate, short-term, and long-term fixes for your approval. ## Quick Start Ask the assistant to diagnose why your Azure App Service is returning 500 errors and produce a remediation plan.

Frequently Asked Questions about azure-resource-health-diagnose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose why an Azure resource is failing?

Identify the resource by name, then assess its provisioning state, availability, and utilization. Query Log Analytics or Application Insights with KQL for errors and performance anomalies, classify findings by severity, and build a phased remediation plan with Azure CLI commands.

How to troubleshoot Azure App Service 500 errors with KQL?

Query the requests table filtered to failed responses over the last 24 hours, summarizing failure counts by result code per hour. Correlate spikes with recent deployments or configuration changes to isolate the root cause before applying fixes.

What tools are required for Azure resource health diagnosis?

The workflow uses the Azure MCP server tools (azmcp-*) when available, falling back to the Azure CLI. The target resource must be deployed and emitting telemetry through Log Analytics or Application Insights for log-based diagnosis to work.

Can I diagnose an Azure resource that has no diagnostic logs enabled?

No meaningful log analysis is possible without telemetry. The recommended action is to enable diagnostic settings on the resource, wait for data to accumulate, then rerun the assessment; only a generic health evaluation is possible otherwise.

Why does Azure resource discovery fail when only a name is provided?

A name alone can match multiple resources across subscriptions or resource groups. The workflow searches all subscriptions and, when multiple matches exist, asks you to specify the subscription or resource group to disambiguate.

Does the diagnosis apply fixes automatically without approval?

No. The workflow presents a health assessment summary and asks for explicit confirmation before generating the detailed remediation report. Corrective actions are only executed after the user approves the proposed plan.