🚀 快速安装

复制以下命令并运行,立即安装此 Skill:

npx @anthropic-ai/skills install microsoft/azure-skills/azure-diagnostics

💡 提示:需要 Node.js 和 NPM

Azure 诊断

权威指南 — 必须遵守

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

触发条件

当用户希望执行以下操作时,激活此技能:

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

规则

  1. 从系统化的诊断流程开始
  2. 可用时,使用 AppLens (MCP) 进行 AI 驱动的诊断
  3. 在深入研究日志之前,先检查资源健康状态
  4. 根据服务类型选择合适的故障排除指南
  5. 记录发现和已尝试的修复步骤

快速诊断流程

  1. 识别症状 – 出了什么问题?
  2. 检查资源健康 – Azure 状态是否正常?
  3. 查看日志 – 日志显示什么?
  4. 分析指标 – 性能模式如何?
  5. 调查近期变更 – 发生了什么变化?

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

服务 常见问题 参考
容器应用 镜像拉取失败、冷启动、健康探测、端口不匹配 container-apps/
函数应用 应用详情、调用失败、超时、绑定错误、冷启动、缺少应用设置 functions/

快速参考

常用诊断命令

# 检查资源健康状态
az resource show --ids 资源ID

# 查看活动日志
az monitor activity-log list -g 资源组名 --max-events 20

# 容器应用日志
az containerapp logs show --name 应用名 -g 资源组名 --follow

# 函数应用日志(查询 App Insights 跟踪记录)
az monitor app-insights query --apps APP-INSIGHTS -g 资源组名 \
  --analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"

AppLens (MCP 工具)

对于 AI 驱动的诊断,请使用:

mcp_azure_mcp_applens
  intent: "诊断 <资源名称> 的问题"
  command: "diagnose"
  parameters:
    resourceId: "<资源ID>"

提供:
- 自动问题检测
- 根本原因分析
- 修复建议

Azure Monitor (MCP 工具)

用于查询日志和指标:

mcp_azure_mcp_monitor
  intent: "查询 <资源名称> 的日志"
  command: "logs_query"
  parameters:
    workspaceId: "<工作区ID>"
    query: "<KQL查询>"

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


检查 Azure 资源健康状态

使用 MCP

mcp_azure_mcp_resourcehealth
  intent: "检查 <资源名称> 的健康状态"
  command: "get"
  parameters:
    resourceId: "<资源ID>"

使用 CLI

# 检查特定资源健康状态
az resource show --ids 资源ID

# 检查近期活动
az monitor activity-log list -g 资源组名 --max-events 20

参考资料

📄 原始文档

完整文档(英文):

https://skills.sh/microsoft/azure-skills/azure-diagnostics

💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。