Automation & Ops ✓ Microsoft · Official azure-monitorapplensresource-healthapp-serviceazure-functionsakskubernetesservice-bus

Azure Production Diagnostics

Systematically investigate Azure production failures, identify root causes, and guide safe remediation.

FollowSkills review · FSRS-2.0
Not recommended
52/ 100 5-point scale 2.6 / 5
Trust16 / 25 · 3.2/5

The skill explicitly defaults to read-only diagnostics, and its AKS guidance forbids restarting, deleting, scaling, upgrading, or reconfiguring unless the user explicitly requests remediation. However, other service guides directly provide commands for scaling, changing registry identity, enabling auto-heal, binding certificates, and changing configuration, without uniform step-by-step confirmation, least-privilege guidance, sensitive-log redaction, data-flow disclosure, or rollback plans, so points are deducted.

Reliability8 / 20 · 2.0/5

It provides a systematic flow covering symptoms, resource health, logs, metrics, and recent changes, and tells the agent to stop and ask when AKS identity is missing. However, it depends on Azure CLI, multiple MCP tools, kubectl, Docker, Kudu, and specific log tables; installation, authentication, permission, version-compatibility, and complete tool-failure feedback are underdocumented. Some commands and queries lack sufficient applicability notes. The score stays within the static-review ceiling because execution was not performed and edge coverage is limited.

Adaptability10 / 15 · 3.3/5

Triggers cover common Azure production-diagnostics scenarios across App Service, Container Apps, Functions, AKS, Event Hubs, and Service Bus, while AKS inputs and stop conditions are relatively clear. However, the scope is very broad, non-fit cases, input/output formats, service-version differences, Chinese-language interaction, and mainland-China network or regional reachability are not addressed. Some core paths depend on Azure online services and MCP, so points are deducted.

Convention8 / 15 · 2.7/5

The skill has triggers, a quick flow, service routing, reference directories, and command examples. Metadata includes MIT licensing, Microsoft authorship, and version 1.1.6; the repository also supplies a license, security policy, CI, and work-in-progress maintenance signals. However, there is no changelog, explicit maintenance owner or update path, dependency/install guidance, FAQ, compatibility matrix, or complete limitations disclosure. Progressive disclosure and troubleshooting remain incomplete if referenced documents or MCP tools are unavailable, so points are deducted.

Effectiveness6 / 15 · 2.0/5

For common Azure diagnostic tasks it supplies reusable CLI, KQL, and MCP templates, evidence ordering, and an output checklist, offering clear value over manual discovery. However, commands use many placeholders, correctness depends on environment, permissions, diagnostic configuration, and tool versions, and remediation suggestions require human review without representative result samples or static verification evidence. The score follows the static ceiling and is reduced for limited completeness and direct usability.

Verifiability4 / 10 · 2.0/5

The material contains concrete commands, KQL, input requirements, evidence ordering, and several safety constraints; the repository also includes generic CI, evaluation workflows, and test code. However, the supplied tests do not demonstrate this azure-diagnostics skill's key paths. The workflows mainly cover generic evaluation and infrastructure, with no skill-specific tests, real outputs, independent corroboration, or versioned change evidence, so only limited static auditability is awarded.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 9ccaf7c3704a
Before you use it
  • Do not treat scaling, configuration, certificate, identity, or auto-heal commands as default executable actions; confirm targets, permissions, blast radius, backups, and rollback first.
  • Azure CLI, MCP, kubectl, log tables, and regional capabilities vary by environment; validate all placeholders, query results, and remediation suggestions manually.
  • Logs, configuration, connection strings, and diagnostic output may contain sensitive data; the documentation lacks redaction, data-minimization, and data-transfer guidance.
  • Mainland-China network, Azure-region, and MCP reachability are unspecified, and there are no Chinese trigger or interaction examples.
See the full review method →

What it does & when to use it

Azure Diagnostics is one skill in the azure-skills plugin within Microsoft's Agent Skills repository. It focuses on troubleshooting Azure production incidents across App Service, Container Apps, Function Apps, AKS, Event Hubs, and Service Bus. Its workflow covers symptoms, resource health, logs, metrics, and recent changes, with optional AppLens, Azure Monitor, and Resource Health MCP support. AKS and Azure Messaging incidents are routed to dedicated troubleshooting documents.

It identifies symptoms, checks Azure resource health, reviews activity and application logs, analyzes metrics and KQL results, investigates recent changes, and documents findings and attempted remediation. The skill supplies Azure CLI examples for resource inspection, activity logs, Container Apps logs, and Application Insights trace queries. It also specifies invocation patterns for AppLens, Azure Monitor, and Resource Health MCP tools.

  1. An App Service engineer investigating high CPU, deployment failures, crashes, slow responses, TLS, or custom-domain issues.
  2. A Function App developer diagnosing invocation failures, timeouts, binding errors, cold starts, or missing app settings.
  3. An AKS operations team investigating pending pods, CrashLoop failures, unavailable nodes, CoreDNS, networking, ingress, or upgrade problems.
  4. A Container Apps engineer diagnosing image-pull failures, cold starts, health probes, or port mismatches.
  5. An Event Hubs or Service Bus SDK developer investigating AMQP connection failures, lost message locks, dead letters, or connectivity errors.

Pros & cons

Pros
  • Covers common production failure modes across several major Azure services.
  • Provides a concrete diagnostic sequence plus Azure CLI, KQL, and MCP usage patterns.
  • Separates AKS and Azure Messaging incidents through explicit routing guidance.
  • The SKILL.md identifies Microsoft as author, version 1.1.6, and MIT as the license.
Limitations
  • Its scope is Azure production troubleshooting rather than general cloud or local-application debugging.
  • AppLens and the other MCP tools are conditional on availability and require suitable environment access.
  • Several detailed guides are referenced under files not included in the supplied material, so their depth cannot be assessed here.
  • The source does not provide independent test coverage or a complete Azure permissions checklist for this individual skill.

How to install

The repository README documents this collection command: npx skills add microsoft/skills. Select the required skills in the wizard; skills are installed in the chosen agent directory, such as .github/skills/ for GitHub Copilot. It also documents Copilot CLI plugin installation: /plugin marketplace add microsoft/skills, followed by /plugin install azure-skills@skills. The supplied material does not document a standalone installation command for azure-diagnostics.

How to use

With the skill loaded, submit a concrete diagnostic request such as “troubleshoot app service” or “AKS pod is pending, investigate the root cause.” The prescribed sequence is to identify symptoms, check resource health, review logs, analyze metrics, and investigate recent changes. Route AKS incidents to AKS Troubleshooting and Event Hubs or Service Bus SDK issues to Messaging Troubleshooting. For MCP calls, provide the resource ID, workspace ID, and KQL query as applicable; for CLI commands, replace RESOURCE_ID, RG, APP, and APP-INSIGHTS with real values.

FAQ

Does the skill automatically repair Azure resources?
The source describes diagnosis, documentation, and remediation recommendations; it does not explicitly state that repairs are executed automatically.
Which Azure tools does it require?
The examples use Azure CLI and define AppLens, Azure Monitor, and Resource Health MCP calls. MCP usage is conditional on availability.
Is it suitable for AKS incidents?
Yes, it provides AKS diagnostic routing, but active AKS intake, evidence gathering, and remediation guidance are routed to the dedicated AKS Troubleshooting document.
Will installing the repository load every skill?
The README recommends selecting only the needed skills during installation and warns that loading all skills can dilute context.

More skills from this repository

All from microsoft/agent-skills

Dev & Engineering ✓ Microsoft · Official

Azure Identity for Python

A practical skill for securing Python Azure applications with Microsoft Entra ID credentials.

Dev & Engineering ✓ Microsoft · Official

Azure Event Hubs Java Skill

Build production-oriented Java event streaming applications on Azure Event Hubs.

Dev & Engineering ✓ Microsoft · Official

Azure Tables for Python

A practical guide to building authenticated Azure Tables applications with Python entity CRUD, queries, and partition-scoped batch operations.

Dev & Engineering ✓ Microsoft · Official

Azure Identity for TypeScript

Configure secure, flexible Microsoft Entra ID authentication for TypeScript Azure applications.

Automation & Ops ✓ Microsoft · Official

Azure Reliability Advisor

Assess and improve reliability for Azure Functions and App Service.

Dev & Engineering ✓ Microsoft · Official

Azure Cloud Architect

Guides coding agents through production-grade Azure architecture design and review using Azure Architecture Center practices.

Dev & Engineering ✓ Microsoft · Official

Azure AI Text Analytics for Python

Guides Python developers through Azure-powered text analysis and NLP workflows.

Automation & Ops ✓ Microsoft · Official

Azure Resource Architecture Visualizer

Analyze Azure resource groups and turn their dependencies into detailed Mermaid architecture diagrams.

Dev & Engineering ✓ Microsoft · Official

Azure Maps for .NET

Build .NET location features for search, routing, maps, geolocation, and weather.

Dev & Engineering ✓ Microsoft · Official

Azure AI Vision Image Analysis

Guides Python coding agents in implementing Azure AI Vision image understanding.

Dev & Engineering ✓ Microsoft · Official

Azure Blob Storage for Python

Guides secure, production-minded Blob Storage operations in Python.

Dev & Engineering ✓ Microsoft · Official

Azure Queue Storage for Python

Gives coding agents reliable Python patterns for secure Azure Queue Storage messaging and asynchronous task processing.

Automation & Ops ✓ Microsoft · Official

Azure AI Gateway Governance

Use Azure API Management to govern traffic across AI models, MCP tools, and agents.

Automation & Ops ✓ Microsoft · Official

AKS Automatic Readiness

Assess Kubernetes workloads for AKS Automatic compatibility and identify migration blockers before you switch.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB ARM for .NET

Provision and manage Azure Cosmos DB resources from .NET through ARM.

Dev & Engineering ✓ Microsoft · Official

Azure Playwright Workspace Manager

Provision and manage Microsoft Playwright Testing workspaces with .NET and Azure Resource Manager.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB for Python

A practical guide for building reliable Python applications on Azure Cosmos DB’s NoSQL API.

Dev & Engineering ✓ Microsoft · Official

Azure Key Vault SDK for Python

Gives Python coding agents practical guidance for securely managing Azure Key Vault secrets, keys, and certificates.

Dev & Engineering ✓ Microsoft · Official

Azure API Management for Python

Gives coding agents practical Python SDK patterns for managing Azure API Management services, APIs, products, subscriptions, and policies.

Dev & Engineering ✓ Microsoft · Official

Azure Monitor Query for Python

Generate Python code for querying Azure Monitor logs and metrics.

Related skills