azure-diagnostics

Diagnose and troubleshoot Azure Container Apps and Function Apps using KQL queries and health checks.

Updated May 12, 2026
One-click install
npx skills add https://github.com/sohamda/apex-try-out-demo-repo --skill azure-diagnostics-sohamda
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-diagnostics
Source: https://github.com/sohamda/apex-try-out-demo-repo/tree/main/.github/skills/azure-diagnostics
Command: npx skills add https://github.com/sohamda/apex-try-out-demo-repo --skill azure-diagnostics-sohamda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging production issues in Azure services requires navigating scattered logs, metrics, and health signals across multiple tools, making root-cause analysis slow and error-prone. ## Core Features & Use Cases - Systematic Diagnosis Workflow: Follows a six-phase process from symptom identification through health assessment, log analysis, and structured report generation. - Service-Specific Troubleshooting Guides: Provides targeted playbooks for Container Apps (image pull failures, cold starts, health probes) and Function Apps (invocation failures, timeouts, missing app settings). - KQL Query Library: Includes ready-to-use Kusto queries for Azure Resource Graph, Application Insights, and Log Analytics to find errors, slow requests, and unhealthy resources. - Use Case: When a Container App keeps restarting in production, use this Skill to check resource health, stream logs, identify a failing health probe, and apply the documented remediation steps. ## Quick Start Ask the agent to troubleshoot why your Azure Container App is failing to start and follow the guided diagnosis flow.

Frequently Asked Questions about azure-diagnostics

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

FAQPage Schema
How do I troubleshoot Azure Container Apps image pull failures?▼

Check the registry configuration with az containerapp show and verify revision status with az containerapp revision list. The typical fix is setting a managed identity for registry access using az containerapp registry set --identity system.

How do I find the App Insights linked to an Azure Function App?▼

Use an Azure Resource Graph query joining microsoft.web/sites with microsoft.insights/components by resource group to get the instrumentation key and workspace. Alternatively, read the APPLICATIONINSIGHTS_CONNECTION_STRING app setting and match it to an App Insights component.

What KQL queries help diagnose Azure application errors?▼

Query AppExceptions for recent errors, AppRequests filtered by Success == false for failed requests, and AppDependencies for dependency failures. Always include a time filter like TimeGenerated > ago(1h) and limit results with take or summarize.

Why does my Azure Container App keep restarting?▼

Repeated restarts usually indicate a failing health probe. Verify the app exposes a /health endpoint returning HTTP 200, check the ingress target port matches the port your app listens on, and review system logs with az containerapp logs show --type system.

When should I not use this diagnostics skill?▼

Do not use it for pre-deployment validation, which belongs to a validation skill, or for cost analysis, which belongs to a cost optimization skill. It is scoped to post-deployment troubleshooting and root-cause analysis of running Azure resources.