1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | appinsights-instrumentation | GitHub API |
| 作者/维护者 | Microsoft（azure-skills 插件的组成技能之一） |
GitHub API |
| 来源链接 | https://github.com/microsoft/azure-skills/tree/main/skills/appinsights-instrumentation | — |
| 许可证 | MIT（技能自带独立 LICENSE.txt） |
GitHub API + 仓库内容 |
| GitHub Stars / Forks | 1,374 / 225（数字属整个插件仓库，由数十个技能共享，不代表本技能自身热度） | GitHub API |
| 最新版本 | 1.2.1（SKILL.md front matter） | 仓库内容 |
| 安装方式 | 多渠道插件安装（见第 10 章） | 仓库 README |
2. 功能介绍与亮点
教 agent 为 Web 应用接入 Azure Application Insights 遥测，覆盖 ASP.NET Core、Node.js、Python 与 Container Apps。区分自动/手动埋点两条路径，手动路径细分 OpenTelemetry Distro / Exporter 两种 SDK 形态并各配独立参考文档；提供 Bicep 模板与 Azure CLI 脚本，几条命令建好 Log Analytics 与 Application Insights 资源并自动写入应用环境变量。职责边界清晰：只做埋点指导与监控资源创建，若用户要求改应用代码会交接给同插件的 azure-prepare，不越权动用户代码库。
3. 适用场景
固定分类：DevOps 与基础设施。
适用于应用已部署在 Azure（App Service / Container Apps / Azure Functions）、需要补齐生产可观测性的开发者：新服务上线前补埋点、老服务事后补监控、多语言团队需要一份可直接照抄的范式。面向 Azure 应用的初中级开发者，不要求预先掌握 OpenTelemetry 内部机制。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——
/plugin install azure@claude-plugins-official - Codex：✅ 原生支持——
codex plugin marketplace add microsoft/azure-skills后经/plugins安装 - OpenClaw / Hermes Agent：❓ 均未验证——README 未提及
同一插件还官方支持 GitHub Copilot、Cursor、Gemini CLI、IntelliJ IDEA。
5. 推荐理由
只做“教会 agent 正确埋点”一件事，不越界改应用逻辑，也不像同插件其他技能那样要求先跑完两个前置技能——打开就能问“ASP.NET Core 服务怎么接 Application Insights”，直接拿到可执行命令与代码片段，把官方最佳实践浓缩成即问即答。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Microsoft 是 Azure 平台的所有者，属第一方官方技能；所属仓库星数由数十个子技能共享，不代表本技能自身热度；未检索到该子技能自身的独立第三方评价 |
| 可用性 | 8 | 文档按三种技术栈分别给出独立参考页，附 Bicep 模板与可直接执行的 CLI 脚本；不依赖插件内其他技能先跑完（与同插件的 azure-deploy 等技能不同，无强制前置门槛）；需一次性安装 Azure MCP Server 并完成 az login 才能使用；仓库近日仍有更新 |
| 安全性 | 9 | 检查清单：①仅执行创建 Log Analytics/Application Insights 资源与写环境变量的 CLI 命令，权限范围明确；②不涉及本技能之外的联网外发，脚本调用目标全部是 Azure 自身 API；③不要求独立 API Key，走用户已有的 Azure CLI 登录态；④SKILL.md 与脚本未见可疑指令或混淆代码；⑤Microsoft 一线厂商信誉良好；⑥License 明确（MIT，且技能目录自带独立 LICENSE.txt）；⑦仓库近日仍有提交，非弃置项目 |
综合评分：8.0（三项均值）。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-deploy（同插件） | 执行已就绪应用的 Azure 部署（azd up/terraform apply） |
面向“上线”而非“监控”，且要求先完整跑完 azure-prepare 与 azure-validate 两个前置技能才能使用，起步门槛明显更高 |
| azure-enterprise-infra-planner（同插件） | 从零架构企业级 Azure 基础设施（网络、身份、合规、多区域拓扑），直接生成 Bicep/Terraform | 定位是“设计与新建整套基础设施”，服务对象是云架构师；本技能只做单一监控资源的接入，改动面小得多，面向普通应用开发者 |
| azure-monitor-opentelemetry-py（Microsoft 官方独立技能） | 专注 Python 单一语言的 Azure Monitor OpenTelemetry SDK 用法 | 覆盖面窄于本技能（本技能横跨 ASP.NET Core/Node.js/Python 三栈并含资源创建脚本），适合已明确技术栈且只需 SDK 层细节的场景 |
| Datadog / Honeycomb 等第三方可观测性技能 | 对接 Datadog、Honeycomb 等第三方 APM 平台 | 服务的可观测性后端不同（第三方 SaaS vs Azure 原生），选型上与用户是否已在使用 Azure 生态强相关，非直接竞争关系 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；已知公开信息仅限少数技能目录站对其功能的转载式介绍，非独立使用评价。
9. 其他补充
技能随 azure-skills 插件整体维护，与同插件内的 azure-prepare、azure-diagnostics 等技能共享同一套 Azure MCP Server 配置，装插件后无需单独认证。
10. 安装使用方式
- Claude Code：
/plugin install azure@claude-plugins-official - Codex CLI：
codex plugin marketplace add microsoft/azure-skills后经/plugins安装 - 按单技能安装：
npx -y skills add microsoft/azure-skills --skill appinsights-instrumentation --agent claude-code - 前置条件：Azure 账号/订阅、Node.js 18+、已
az login认证的 Azure CLI
安装后无需重启，直接问“如何为我的 XX 应用接入 Application Insights”即可触发。
11. 注意事项
- 只提供指导与创建监控资源，不改用户应用源码——需要改代码会被引导至
azure-prepare。 - 要求应用已托管在 Azure，本地开发环境或非 Azure 托管场景不适用。
- 依赖 Azure MCP Server 与已认证的 Azure CLI，非零配置开箱即用。
- OpenClaw、Hermes Agent 因缺官方材料标注未验证，不代表不兼容。