azure-diagnostics

Diagnose Azure production issues using AppLens, Azure Monitor, KQL, and kubectl.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/merceralex397-collab/alex-stack --skill azure-diagnostics-merceralex397-collab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-diagnostics
Source: https://github.com/merceralex397-collab/alex-stack/tree/main/dev/azure-profile/azure-skills-main/azure-skills-main/.github/plugins/azure-skills/skills/azure-diagnostics
Command: npx skills add https://github.com/merceralex397-collab/alex-stack --skill azure-diagnostics-merceralex397-collab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging Azure production incidents requires jumping between portals, logs, metrics, and CLI tools. This Skill provides a systematic triage workflow that routes symptoms to the right diagnostic path, checks resource health first, and surfaces root causes with evidence before remediation. ## Core Features & Use Cases - Service-Specific Troubleshooting Guides: Dedicated playbooks for Container Apps (image pull failures, cold starts, health probes), App Service (high CPU, deployment failures, TLS issues), Function Apps (invocation failures, missing App Insights linkage), AKS (CrashLoopBackOff, node NotReady, DNS, ingress), and Event Hubs/Service Bus SDK errors across .NET, Java, JavaScript, and Python. - AI-Assisted Diagnostics via MCP Tools: Uses AppLens for automated root cause analysis, Azure Monitor for KQL log queries, and Resource Health checks before deep-diving into logs. - Ready-to-Run Query Libraries: Includes KQL query references for errors, failed requests, and slow dependencies, plus Azure Resource Graph queries to find degraded resources across subscriptions. - Use Case: When an AKS pod is stuck in CrashLoopBackOff, the Skill routes you to the pod-failures playbook, checks exit codes and previous logs, and maps exit code 137 to an OOMKilled memory-limit fix. ## Quick Start Ask the assistant to troubleshoot your Azure resource, for example: diagnose why my App Service app is returning 503 errors and check its recent deployments and logs.

Frequently Asked Questions about azure-diagnostics

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

FAQPage Schema
How do I troubleshoot an AKS pod stuck in CrashLoopBackOff?▼

Run kubectl describe pod to check the exit code and events, then kubectl logs --previous to see the last crash output. Exit code 137 means OOMKilled, so increase the memory limit; exit code 1 indicates an application error visible in the logs.

How do I find the App Insights linked to my 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 ID. As a fallback, read the APPLICATIONINSIGHTS_CONNECTION_STRING app setting and match it with az monitor app-insights component show.

What causes image pull failures in Azure Container Apps?▼

Image pull failures usually come from missing ACR credentials or a wrong image tag. Check the registry configuration with az containerapp show and fix it by running az containerapp registry set with a managed identity.

Why does my Service Bus message lock get lost before expiry?▼

MessageLockLost can occur from an AMQP link detach caused by transient network issues or the 10-minute idle timeout, not only from long processing. Reduce processing time, use auto-lock renewal, and treat clients as singletons to avoid connection churn.

Should I use DefaultAzureCredential in production for Event Hubs?▼

No. DefaultAzureCredential is intended for local development because its fallback chain adds latency and unpredictability. In production, use ManagedIdentityCredential with RBAC roles assigned at the narrowest scope.

Can this Skill restart or scale my AKS cluster automatically?▼

No. The AKS guidance defaults to read-only diagnostics and explicitly forbids restarting, draining, scaling, or upgrading resources unless the user explicitly requests remediation and confirms the workload impact.