Azure诊断指南：官方生产问题排查与调试权威教程

azure-diagnostics by microsoft/azure-skills

76,900 周安装量

497 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/microsoft/azure-skills --skill azure-diagnostics

🇨🇳中文介绍

Azure 诊断

权威指南 — 强制遵守

本文档是调试和排查 Azure 生产问题的官方来源。请遵循这些说明，系统地诊断和解决常见的 Azure 服务问题。

触发条件

当用户想要进行以下操作时，激活此技能：

调试或排查生产问题
诊断 Azure 服务中的错误
分析应用程序日志或指标
修复镜像拉取、冷启动或运行状况探测问题
调查 Azure 资源失败的原因
查找应用程序错误的根本原因
排查 Azure 函数应用问题（调用失败、超时、绑定错误）
查找与函数应用关联的 App Insights 或 Log Analytics 工作区

规则

从系统诊断流程开始
可用时，使用 AppLens (MCP) 进行 AI 驱动的诊断
深入查看日志前，先检查资源运行状况
根据服务类型选择合适的故障排除指南
记录发现的问题和已尝试的修复步骤

快速诊断流程

识别症状 - 什么失败了？
检查资源运行状况 - Azure 是否正常？
查看日志 - 日志显示了什么？
分析指标 - 性能模式如何？
调查近期变更 - 发生了什么变化？

按服务分类的故障排除指南

服务	常见问题	参考

🇺🇸English

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

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

Quick Diagnosis Flow

Identify symptoms - What's failing?
Check resource health - Is Azure healthy?
Review logs - What do logs show?
Analyze metrics - Performance patterns?
- What changed?

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

AppLens (MCP 工具)

对于 AI 驱动的诊断，使用：

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 工具)

用于查询日志和指标：

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

有关常见的诊断查询，请参阅 kql-queries.md。

检查 Azure 资源运行状况

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

# 检查特定资源运行状况
az resource show --ids RESOURCE_ID

# 检查近期活动
az monitor activity-log list -g RG --max-events 20

Investigate recent changes

Troubleshooting Guides by Service

Service	Common Issues	Reference
Container Apps	Image pull failures, cold starts, health probes, port mismatches	container-apps/
Function Apps	App details, invocation failures, timeouts, binding errors, cold starts, missing app settings	functions/

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"

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 for common diagnostic queries.

Check Azure Resource Health

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

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

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

容器应用	镜像拉取失败、冷启动、运行状况探测、端口不匹配	container-apps/
函数应用	应用详情、调用失败、超时、绑定错误、冷启动、缺少应用设置	functions/

Azure诊断指南：官方生产问题排查与调试权威教程

🇨🇳中文介绍

Azure 诊断

触发条件

规则

快速诊断流程

按服务分类的故障排除指南

🇺🇸English

Azure Diagnostics

Triggers

Rules

Quick Diagnosis Flow

相关 Skills

快速参考

常用诊断命令

AppLens (MCP 工具)

Azure Monitor (MCP 工具)

检查 Azure 资源运行状况

使用 MCP

使用 CLI

参考

Troubleshooting Guides by Service

Quick Reference

Common Diagnostic Commands

AppLens (MCP Tools)

Azure Monitor (MCP Tools)

Check Azure Resource Health

Using MCP

Using CLI

References