Azure Application Insights 接入

技能简介

Azure Application Insights 是 Azure 官方 APM 工具，但跨语言、跨宿主（App Service、Container Apps、Functions）配置差异很大。本技能为 Claude、Codex、Claude Code 提供 SDK 选型、Bicep 基础设施、环境变量、KQL 查询一条龙参考，让 AI 帮你规划 Application Insights 接入与诊断。

核心能力

• 解释 Azure App Service 门户自动注入（auto-instrumentation）的支持范围
• 提供 ASP.NET Core、Node.js、Python 三个主流语言的手动 SDK 接入步骤
• 给出 Application Insights + Log Analytics 资源的 Bicep 与 Azure CLI 示例
• 覆盖 Container Apps：指标、日志、分布式追踪、Dapr、KQL 诊断
• 汇总 Azure Monitor OpenTelemetry 在 Python / TypeScript / Java 的接入路径

安装配置

• 一行安装：npx skillstore add microsoft/appinsights-instrumentation
• 依赖：Azure CLI（az）、可选 Bicep、目标语言 SDK
• 权限：订阅级 Contributor 或 Monitoring Contributor 角色
• 兼容工具：Claude / Codex / Claude Code

使用步骤

1. 在 Agent 中加载本技能，告诉 Agent 你的语言（Python / Node / .NET）和宿主（App Service / Container Apps）
2. 用「Choose an Instrumentation Method」模板确定走自动注入还是手动 SDK
3. 让 Agent 按「Create a Manual Setup Plan」生成 SDK 安装、初始化、配置、部署四阶段清单
4. 用「Review Azure Infrastructure」模板审查 Bicep / Azure CLI 资源模板
5. 上线后用「Design Distributed Observability」模板规划 KQL 调查与采样策略

适用场景

• 新 Azure 项目接入 APM，统一 .NET / Node / Python 团队的遥测规范
• 把现有应用迁移到 Container Apps，需要补齐分布式追踪
• 故障排查：用 KQL 查询请求、依赖、异常等维度
• 成本优化：评估采样率、Retention、Log Analytics 用量
• 安全合规：审计连接字符串的存储位置、Key Vault 集成

适用人群

• Azure 后端工程师，负责 App Service / Container Apps 服务可观测性
• SRE / 运维工程师，搭建统一的监控告警体系
• 平台架构师，规划跨语言团队的遥测规范
• DevOps 工程师，编写 Bicep / Terraform 基础设施代码

工作原理

技能以 OpenTelemetry 与 Application Insights SDK 官方文档为基础，结合 Azure 各托管服务的实际约束（环境变量注入、网络出站、托管标识）形成参考库。Agent 根据用户描述的服务类型选择 SDK 与配置路径。安全审计结论为「示例与文档无越权行为」，所有连接字符串均提示通过托管配置或 Key Vault 引用，禁止硬编码。

官方链接

• 技能页：https://skillstore.io/skills/microsoft-appinsights-instrumentation
• 源码仓库：https://github.com/microsoft/github-copilot-for-azure/tree/main/plugin/skills/appinsights-instrumentation/
• Manifest：https://skillstore.io/api/skills/microsoft-appinsights-instrumentation/manifest
• 安装命令：npx skillstore add microsoft/appinsights-instrumentation