azure-diagnostics

Diagnose Azure incidents using health checks, logs, metrics, KQL, and network analysis.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill azure-diagnostics-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-diagnostics
Source: https://github.com/leonardoacosta/skills/tree/main/azure-kit/skills/azure-diagnostics
Command: npx skills add https://github.com/leonardoacosta/skills --skill azure-diagnostics-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Troubleshooting Azure incidents often means jumping between portals, CLI commands, and telemetry tools without a clear method, leading to guesswork and risky changes. This Skill provides a systematic, evidence-first diagnostic workflow for Azure resources before any remediation is attempted. ## Core Features & Use Cases - Systematic Diagnosis: Builds an evidence chain from symptom, scope, time window, and recent changes, separating observed facts from unavailable or inferred evidence. - Service-Specific Playbooks: Four reference playbooks cover resource health and AppLens-style analysis, logs/metrics/KQL/Resource Graph, Container Apps and Functions, and network diagnostics (DNS, NSG, routes, private endpoints). - Safe CLI Fallbacks: Provides read-only Azure CLI and KQL starting points when specialized diagnostic integrations are unavailable, and requires authorization before any mutation. - Use Case: When a Container App revision fails health probes after a deployment, use this Skill to correlate revision state, system logs, probe configuration, and recent changes to identify the root cause before restarting or rolling back. ## Quick Start Ask the agent to diagnose why your Azure Container App is unhealthy, providing the resource ID and the UTC time window when the issue started.

Frequently Asked Questions about azure-diagnostics

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

FAQPage Schema
How do I diagnose an unhealthy Azure resource?

Start by recording the resource ID, subscription, region, and UTC time window, then check Azure Service Health, Resource Health, and the activity log before interpreting application symptoms. Correlate logs, metrics, and recent configuration changes before attempting any remediation.

How to troubleshoot Azure Container Apps probe failures?

Inspect the active revisions, system and console logs, ingress target port, and probe type, port, path, and timing. A probe failure may come from an application crash, a port or path mismatch, or overly aggressive timing, so prove the cause before changing configuration.

What KQL queries help find Azure application errors?

Query AppExceptions for recent exceptions, AppRequests filtered by Success == false for failed requests, and AppDependencies for dependency failures, all bounded by a UTC time window. Verify table and column names against the workspace schema since they vary by telemetry mode.

Why does my Azure connection time out with no error?

A silent timeout commonly indicates an NSG deny, but it does not distinguish that from routing or firewall causes. Check DNS resolution from the source, evaluate source outbound and destination inbound NSG rules by priority, and inspect effective routes and private endpoint state.

Can I diagnose Azure issues without AppLens or special integrations?

Yes, the Skill provides safe read-only Azure CLI fallbacks such as az monitor activity-log list, az monitor metrics list, and az graph query, plus the portal's Diagnose and solve problems experience. Record that automated analysis was unavailable rather than inventing evidence.

When should I escalate an Azure issue to Microsoft support?

Escalate only after documenting evidence that rules out narrower causes: service and resource health, configuration, identity, DNS, NSG rules, routes, private endpoints, firewalls, and application listeners. Present observed facts with sources and UTC time ranges alongside unavailable evidence.