Azure Diagnostics 是一份用于调试和排查 Azure 生产问题的技能文档,定位为 Azure 生产问题诊断的官方指导来源。其目标是按照系统化方式诊断和解决常见的 Azure 服务问题。
【触发场景】 当用户需要调试或排查生产问题时激活,包括:诊断 Azure 服务中的错误;分析应用日志或指标;修复镜像拉取、冷启动或健康探测问题;调查 Azure 资源失败原因;查找应用错误根因;排查 App Service 问题(高 CPU、部署失败、崩溃、响应缓慢、TLS/自定义域);响应诸如“troubleshoot app service”“app service high CPU”“app service deployment failure”等请求;排查 Azure Function Apps(调用失败、超时、绑定错误、冷启动、缺少应用设置);查找与 Function App 关联的 App Insights 或 Log Analytics 工作区;排查 AKS 集群、节点、Pod、入口或 Kubernetes 网络问题;排查 Azure VM 连接问题(RDP/SSH 失败、端口 3389/22 超时、NSG 或防火墙拦截、凭据重置);排查 Azure 消息 SDK 问题(Event Hubs、Service Bus 连接失败、AMQP 错误、消息锁问题);以及对“运行时健康但目标错误”类症状进行根因分析(例如配置变更后遥测或消息停止流向预期资源),即使 MCP 工具可单独回答表面问题,也应调用本技能使用其矩阵。
【规则】 从系统性诊断流程开始。优先使用提供的证据;如果用户要求仅基于证据分析或禁止实时 Azure 访问,则不要查询或修改 Azure,应基于提供的日志、指标和时间线进行诊断,明确假设并提供可选的验证步骤。在可用时使用 AppLens(MCP)进行 AI 驱动诊断。在深入日志前先检查资源健康。根据服务类型选择适当的故障排查指南。记录发现结果和尝试的补救步骤。在标识符已知且允许实时收集时,优先使用内置诊断脚本而非临时调用;如果提供的证据足够或禁止实时访问,则不运行脚本,否则先运行适用的脚本。将 AKS 事件路由到专门的 AKS 故障排查文档。即使可选的 aks-skills 附加组件缺失、被拒绝或宿主不支持,也保持基线 AKS 诊断可用。
【快速诊断流程】 识别症状——什么在失败?检查资源健康——Azure 是否健康?查看日志——日志显示了什么?分析指标——性能模式如何?调查最近变更——发生了什么变化?
【按服务的故障排查指南】 Container Apps:镜像拉取失败、冷启动、健康探测、端口不匹配。App Service:高 CPU、部署失败、崩溃、响应缓慢、TLS/自定义域。Function Apps:应用详情、调用失败、超时、绑定错误、冷启动、缺少应用设置。AKS:集群访问、节点、kube-system、调度、崩溃循环、入口、DNS、升级。Compute:VM RDP/SSH 连接、NSG/防火墙拦截、凭据重置、VM 代理/工具问题。Messaging:Event Hubs 与 Service Bus SDK 错误、AMQP 失败、消息锁、连接性。
【路由规则】 Container Apps 和 Function Apps 诊断保留在此父技能中。活动的 AKS 事件、AKS 特定接入、证据收集和补救指导路由到 AKS 故障排查。Azure VM RDP/SSH 连接、NSG/防火墙、凭据重置和 VM 代理故障排查路由到 VM 连接故障排查。Azure 消息 SDK 故障排查(Event Hubs、Service Bus)路由到消息故障排查。
【常用诊断命令】 检查资源健康:az resource show --ids RESOURCE_ID 查看活动日志:az monitor activity-log list -g RG --max-events 20 Container Apps 日志:az containerapp logs show --name APP -g RG --follow Function App 日志(查询 App Insights 跟踪):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 工具)】 用于 AI 驱动诊断:mcp_azure_mcp_applens,intent: "diagnose issues with <resource-name>",command: "diagnose",parameters: resourceId: "<resource-id>"。提供自动问题检测、根因分析和补救建议。
【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:mcp_azure_mcp_resourcehealth,intent: "check health status of <resource-name>",command: "get",parameters: resourceId: "<resource-id>"。 使用 CLI:检查特定资源健康 az resource show --ids RESOURCE_ID;检查最近活动 az monitor activity-log list -g RG --max-events 20。
【参考资料】 包括 KQL 查询库、Azure Resource Graph 查询、App Service 故障排查、Function Apps 故障排查、VM 连接故障排查、消息故障排查。
关于该技能的收费、价格、平台或具体授权方式,资料中暂未提供。