Azure Monitor 可观测性指南

你在什么场景会用到它

在 Azure 上跑 Log Analytics、Azure Monitor Agent (AMA)、Application Insights 或 Container Insights 时，常见问题并不缺文档，而是缺「从症状到正确章节」的路径：Linux/Windows 代理不上报、DCR 管道报错、日志/指标警报误报、工作区摄取变慢、ITSMC 连 ServiceNow 失败、AKS Prometheus 指标缺失等。规划阶段还要在单工作区/多工作区、Private Link、OpenTelemetry 采样和成本之间做取舍。

技能如何组织知识

本技能把 Microsoft Learn 上的 Azure Monitor 材料做成可检索结构，并保留本地快速参考：

• 问题排查（SKILL 内行号段）：代理、数据收集与管道、警报、指标/日志、App Insights、容器、VM 性能、ITSM 连接器等诊断入口
• 最佳实践 / 决策制定：成本、自动缩放、K8s/VM 监控、PromQL/KQL、多云可观测性选型
• 架构、配额与安全：企业布局、限制与配额、RBAC/私有访问/审计日志查询等
• configuration.md / integrations.md / deployment.md：各资源 schema、Webhook/REST/KQL 集成模式，以及 Policy/ARM/CLI 批量部署

Agent 通过分类索引定位章节；带行号范围时用 read_file 读指定行，带文件链接时读关联参考文件。远程文档优先 mcp_microsoftdocs:microsoft_docs_fetch（查询参数 from=learn-agent-skill），备用 fetch_webpage（accept=text/markdown）。

使用边界

• 需要网络拉取 Learn 内容；无 mcp_microsoftdocs 时需按技能提示自行安装 MCP。
• 若 metadata.generated_at 超过约 3 个月，本地索引可能滞后，建议从仓库更新技能包。
• 技能是指南与文档路由，不会代替你在订阅里改 RBAC、部署代理或执行 KQL 变更。