azure-diagnostics

The azure-diagnostics skill provides a structured approach to debugging and troubleshooting Azure production issues. It helps users systematically identify and resolve problems affecting Azure resources, including Container Apps, Function Apps, and Azure Kubernetes Service (AKS) clusters. By integrating tools like AppLens, Azure Monitor, and resource health checks, this skill simplifies the complex process of diagnosing failures such as image pull errors, cold starts, health probe failures, node unavailability, and crash loops. It is designed to assist engineers in quickly pinpointing root causes and taking appropriate remediation steps, ensuring minimal downtime and improved service reliability.

Key features of the azure-diagnostics skill include a quick diagnosis flow that guides users from symptom identification to resource health checks, log review, metrics analysis, and recent change investigations. It offers service-specific troubleshooting guides for Container Apps, Function Apps, and AKS clusters, with direct references to detailed documentation. The skill also supports AI-powered diagnostics via AppLens for automated root cause analysis and remediation recommendations, as well as log and metric queries through Azure Monitor using KQL. Commands and workflows are provided for common diagnostic tasks, making it easier to perform consistent and effective troubleshooting.

This skill is primarily targeted at Azure engineers, DevOps professionals, and IT administrators responsible for maintaining production environments. Use cases include diagnosing application errors, resolving container orchestration issues, investigating failed deployments, analyzing logs for performance bottlenecks, and determining the root cause of infrastructure failures. By following the structured guidance and leveraging the integrated tools, users can enhance operational efficiency, reduce incident resolution times, and maintain the health of critical Azure services.