1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-managed-grafana-MicrosoftDocs-Agent-Skills |
| 项目自述名称 | Azure Managed Grafana Skill |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方账号） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-managed-grafana |
| 许可证 | 内容 CC BY 4.0 + 代码 MIT（数据来自仓库 LICENSE / LICENSE-CODE 文件，与合集仓库其余子技能一致） |
| GitHub Stars | 733★（数据来自 GitHub API；为合集仓库整体数字，仓库下共 200+ 个子技能，不代表本技能自身热度） |
| Forks | 117（同上，合集整体数字） |
| 最新版本 | 无独立版本号，SKILL.md 元数据标注 generated_at: 2026-08-31，仓库按周期从 Microsoft Learn 文档同步重新生成 |
| 安装方式 | Claude Code 插件市场 /plugin marketplace add MicrosoftDocs/agent-skills 后安装子技能，或手动复制 skills/azure-managed-grafana 目录到所用 agent 的 skills 目录 |
2. 功能介绍与亮点
azure-managed-grafana 是围绕 Azure Managed Grafana（Azure 官方托管版 Grafana 服务）编写的专家知识技能，本地索引覆盖六大主题：故障排查、决策制定、限额与配额、安全、配置、集成与编码模式。技能采用“本地索引 + 按需联网抓取”架构——SKILL.md 正文只放分类索引与官方文档链接表，agent 触发时通过 mcp_microsoftdocs:microsoft_docs_fetch（首选）或通用 fetch_webpage（回退）实时取回 Microsoft Learn 官方文档全文，保证内容始终与官方文档同步、不会因技能本身过时而给出过期指引。
具体覆盖的实操知识包括：私有终结点连接与 DNS 故障排查、从自托管/Azure Grafana Essential 迁移到 Managed Grafana、Grafana 12 版本升级路径、区域可用性与配额限制、数据面 API 鉴权与角色权限管理、Entra 用户组同步、私有终结点与出站 IP 配置、区域冗余、插件与 SMTP 告警邮件配置，以及与 AKS/Prometheus、Azure AI Foundry 仪表盘、Azure Data Explorer 的集成模式。六大分类合计覆盖 20+ 个具名 Microsoft Learn 文档主题，是同仓库中内容密度较高的子技能之一。
亮点：① 官方一手来源，链接全部指向 learn.microsoft.com 而非第三方转述；② generated_at: 2026-08-31，内容更新时间距今仅数天，处于新鲜状态；③ SKILL.md 内置“若 generated_at 超过 3 个月建议拉取最新版”的自我保鲜提示，降低内容过期风险。
3. 适用场景
所属分类：DevOps 与基础设施
适用于在 Azure 上运维、部署或排查 Grafana 监控仪表盘的团队与个人：需要为 AKS/Prometheus 环境接入托管 Grafana 做可观测性看板的 DevOps/SRE 工程师；需要处理私有终结点连接失败、Grafana 12 升级、跨租户迁移等具体故障的运维人员；需要为 Azure AI Foundry Agent 应用搭建 Token 用量、成本、错误率监控仪表盘的 AI 平台工程师；以及需要理解 Managed Grafana 区域限额、SKU 与安全角色配置以做容量规划的架构师。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方插件市场提供一键安装路径（/plugin marketplace add MicrosoftDocs/agent-skills），且 Claude Code 内置 WebFetch 类工具可承接 fetch_webpage 回退路径 |
| Codex | ⚠️ 需适配 | 技能运行时依赖联网抓取 Microsoft Learn 文档，Codex CLI 默认沙箱环境不开放出站网络访问，需手动放开网络权限或改用受限于本地索引摘要的降级模式（本池 MicrosoftDocs 系列技能的一致结论） |
| OpenClaw | ❓ 未验证 | 技能本身是通用 Markdown + YAML front matter 格式，理论上可安装，但公开检索未获得该平台的实际验证信息 |
| Hermes Agent | ❓ 未验证 | 同上，未获得该平台的实际验证信息 |
5. 推荐理由
Azure Managed Grafana 是 Azure 官方托管的可观测性看板服务，配置项（私有终结点、区域限额、迁移路径、Entra 集成）分散在数十篇独立文档中，人工检索成本高。本技能把这些知识点整理成结构化索引并保持与官方文档实时同步，能显著缩短工程师在私有终结点故障排查、版本升级、迁移评估等具体场景下查找权威答案的时间，且不存在“技能内容过时”的风险——所有深度内容都是运行时现取的官方原文。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 官方一线厂商出品，发布方即 Azure Managed Grafana 服务的所有者；公开检索未见来自开发者社区（Reddit、Hacker News、具名博客）针对本技能的独立第三方评测或可量化采用数据 |
| 可用性 | 9 | 一条插件市场命令或手动复制目录即可安装；generated_at: 2026-08-31，内容更新距今仅数天，处于新鲜状态；分类索引覆盖六大主题、20+ 具名文档链接，内容密度在同仓库中偏高；无付费依赖 |
| 安全性 | 9 | 纯文档/参考类技能，不在本地执行代码；仅通过官方 MCP 工具或网页抓取访问 learn.microsoft.com 官方域名，外联目标透明；License 明确（CC BY 4.0 + MIT）；官方账号维护，无造假迹象 |
综合评分：8.33（三项均值）
安全检查清单：①无 shell 命令执行 ②仅联网抓取 Microsoft Learn 官方文档，无其他数据外发 ③不要求 API Key 或凭据，正文涉及的鉴权配置指引针对的是 Grafana 数据面 API 本身而非本技能运行所需 ④SKILL.md 正文未见可疑指令或隐蔽外发 ⑤作者为 Microsoft 官方账号，信誉明确 ⑥License 明确（CC BY 4.0 + MIT） ⑦最近一次内容更新为 2026-08-31，处于新鲜状态
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| grafana-oss-grafana-skills | Grafana 官方出品，覆盖自托管/云端通用 Grafana OSS 核心功能 | 面向通用 Grafana，不含 Azure Managed Grafana 特有的私有终结点、区域配额、Entra 组同步等云原生托管服务细节 |
| promql-grafana-skills | Grafana 官方出品，专攻 PromQL 查询语法与调优 | 只覆盖单一查询语言维度，不涉及 Azure 托管服务本身的部署、迁移、安全配置 |
| azure-monitor-MicrosoftDocs-Agent-Skills | Microsoft 官方出品，Azure 原生监控与遥测服务知识 | 与 Managed Grafana 是 Azure 监控生态中并行的两条产品线（数据后端不同），该技能 SKILL.md 正文明确注明“不适用于 Azure Managed Grafana 场景，请改用本技能” |
8. 用户评价
该技能目前在第三方平台（GitHub Issues/Discussions、Reddit、Hacker News）尚无具名用户评价。
9. 其他补充
仓库统一由 docs2skills 生成器从 Microsoft Learn 官方文档源批量生成并周期性同步，属官方文档到技能的自动化管线产物，非个人手工维护。
10. 安装使用方式
- 插件市场：在支持 Agent Skills 插件市场的客户端中执行市场添加与安装命令（如 Claude Code 的
/plugin marketplace add MicrosoftDocs/agent-skills），选择azure-managed-grafana子技能安装。 - 手动安装：克隆
MicrosoftDocs/Agent-Skills仓库，将skills/azure-managed-grafana目录复制到所用 agent 的 skills 目录（如 Claude Code 的.claude/skills/）。 - 安装后注意事项：技能运行时需要联网调用
mcp_microsoftdocs:microsoft_docs_fetch（推荐）或fetch_webpage（回退）取回文档正文，请确保所用 agent 的运行环境已开启网络访问权限，否则技能仅能返回本地索引摘要，无法取回完整文档内容；无需重启，加载后即可在相关对话中被自动或手动触发，例如直接说“帮我排查 Azure Managed Grafana 私有终结点连不通的问题”。
11. 注意事项
- 本技能不含预置代码执行逻辑，全部深度内容依赖运行时联网抓取官方文档，网络不可用或访问受限（如部分沙箱环境默认关闭出站网络）时技能只能提供本地索引摘要，无法取回完整参考内容。
- SKILL.md 元数据若显示
generated_at超过 3 个月，建议从仓库拉取最新版本，避免文档链接与 Azure 门户实际功能出现偏差。 - 技能聚焦 Azure Managed Grafana 本身的部署、故障排查与配置知识参考，不覆盖通用 Grafana OSS 自托管场景，也不替代对生产环境容量规划与安全基线的实际评审。