---
id: sm-azure-diagnostics
name: "azure-diagnostics"
url: https://skills.yangsir.net/skill/sm-azure-diagnostics
author: microsoft
domain: ai-system-observability-sre
tags: ["azure-monitor", "application-insights", "log-analytics", "troubleshooting", "performance-monitoring"]
install_count: 296600
rating: 4.80 (2000 reviews)
github: https://github.com/microsoft/github-copilot-for-azure
---

# azure-diagnostics

> 提供Azure云环境中应用程序和基础设施的诊断支持，帮助用户识别、分析和解决性能问题及故障，确保系统稳定运行。

**Stats**: 296,600 installs · 4.8/5 (2000 reviews)

## Before / After 对比

### Azure诊断问题快速定位

## Readme

# azure-diagnostics

# Azure Diagnostics

**AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE**

This document is the **official source** for debugging and troubleshooting Azure production issues. Follow these instructions to diagnose and resolve common Azure service problems systematically.

## Triggers

Activate this skill when user wants to:

- Debug or troubleshoot production issues

- Diagnose errors in Azure services

- Analyze application logs or metrics

- Fix image pull, cold start, or health probe issues

- Investigate why Azure resources are failing

- Find root cause of application errors

- Troubleshoot Azure Function Apps (invocation failures, timeouts, binding errors)

- Find the App Insights or Log Analytics workspace linked to a Function App

- Troubleshoot AKS clusters, nodes, pods, ingress, or Kubernetes networking issues

## Rules

- Start with systematic diagnosis flow

- Use AppLens (MCP) for AI-powered diagnostics when available

- Check resource health before deep-diving into logs

- Select appropriate troubleshooting guide based on service type

- Document findings and attempted remediation steps

- Route AKS incidents to the dedicated AKS troubleshooting document

## Quick Diagnosis Flow

- **Identify symptoms** - What's failing?

- **Check resource health** - Is Azure healthy?

- **Review logs** - What do logs show?

- **Analyze metrics** - Performance patterns?

- **Investigate recent changes** - What changed?

## Troubleshooting Guides by Service

Service
Common Issues
Reference

**Container Apps**
Image pull failures, cold starts, health probes, port mismatches
[container-apps/](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/container-apps/README.md)

**Function Apps**
App details, invocation failures, timeouts, binding errors, cold starts, missing app settings
[functions/](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/functions/README.md)

**AKS**
Cluster access, nodes, `kube-system`, scheduling, crash loops, ingress, DNS, upgrades
[AKS Troubleshooting](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/aks-troubleshooting/aks-troubleshooting.md)

## Routing

- Keep Container Apps and Function Apps diagnostics in this parent skill.

- Route active AKS incidents, AKS-specific intake, evidence gathering, and remediation guidance to [AKS Troubleshooting](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/aks-troubleshooting/aks-troubleshooting.md).

## Quick Reference

### Common Diagnostic Commands

```
# Check resource health
az resource show --ids RESOURCE_ID

# View activity log
az monitor activity-log list -g RG --max-events 20

# Container Apps logs
az containerapp logs show --name APP -g RG --follow

# Function App logs (query App Insights traces)
az monitor app-insights query --apps APP-INSIGHTS -g RG \
  --analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"

```

### AppLens (MCP Tools)

For AI-powered diagnostics, use:

```
mcp_azure_mcp_applens
  intent: "diagnose issues with <resource-name>"
  command: "diagnose"
  parameters:
    resourceId: "<resource-id>"

Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendations

```

### Azure Monitor (MCP Tools)

For querying logs and metrics:

```
mcp_azure_mcp_monitor
  intent: "query logs for <resource-name>"
  command: "logs_query"
  parameters:
    workspaceId: "<workspace-id>"
    query: "<KQL-query>"

```

See [kql-queries.md](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/kql-queries.md) for common diagnostic queries.

## Check Azure Resource Health

### Using MCP

```
mcp_azure_mcp_resourcehealth
  intent: "check health status of <resource-name>"
  command: "get"
  parameters:
    resourceId: "<resource-id>"

```

### Using CLI

```
# Check specific resource health
az resource show --ids RESOURCE_ID

# Check recent activity
az monitor activity-log list -g RG --max-events 20

```

## References

- [KQL Query Library](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/kql-queries.md)

- [Azure Resource Graph Queries](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/azure-resource-graph.md)

- [Function Apps Troubleshooting](https://github.com/microsoft/github-copilot-for-azure/blob/HEAD/plugin/skills/azure-diagnostics/references/functions/README.md)

Weekly Installs103.1KRepository[microsoft/githu…or-azure](https://github.com/microsoft/github-copilot-for-azure)GitHub Stars157First SeenJan 29, 2026Security Audits[Gen Agent Trust HubPass](/microsoft/github-copilot-for-azure/azure-diagnostics/security/agent-trust-hub)[SocketPass](/microsoft/github-copilot-for-azure/azure-diagnostics/security/socket)[SnykPass](/microsoft/github-copilot-for-azure/azure-diagnostics/security/snyk)Installed ongithub-copilot103.0Kcodex483gemini-cli468opencode444cursor432kimi-cli430

---
*Source: https://skills.yangsir.net/skill/sm-azure-diagnostics*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-azure-diagnostics/markdown*