Azure Application Insights 插桩指南
为 Azure 上的 ASP.NET Core 和 Node.js Web 应用提供 Application Insights 遥测集成指导。
技能明确区分仅提供指导与实际修改，并要求确认未知托管环境，且容器示例推荐使用 secretref；因此具备基本边界和最小化操作意识。扣分原因是未系统说明遥测中的敏感数据、数据流、权限范围、用户确认点和回滚方案，部分环境变量及 Azure CLI 操作可能暴露连接字符串。
主流程和 ASP.NET Core、Node.js、Python、Container Apps 参考较清晰，并包含部分异常配置提示。扣分原因是前置条件仅列 ASP.NET Core 和 Node.js，却又提供 Python、Java 和容器指南；多处引用的 scripts/appinsights.ps1 未出现在给定材料中；Java 示例使用已弃用的 beta 导出器；没有该技能关键路径的专门测试或可复现失败反馈。
触发词、何时使用以及何时转交 azure-prepare 写得较明确，也覆盖多种语言和 Azure 托管形态。扣分原因是声明的适用范围与实际参考内容不一致，未充分定义非 Azure、非支持托管环境及生产数据治理边界，也没有中文使用或中国大陆网络可达性的说明。
SKILL.md 采用渐进式结构，包含元数据、版本 1.1.2、MIT 许可、安装片段、平台参考和部分限制提示；仓库还提供通用测试、许可证和安全政策。扣分原因是缺少技能专属 changelog、维护责任与更新路径、FAQ、依赖版本策略和完整故障排查；引用的外部材料及脚本在给定证据中不完整。
对于理解 Application Insights 概念、选择基本 SDK 初始化方式和配置连接字符串，材料具有直接参考价值，部分命令和代码可复用。扣分原因是静态材料无法验证结果；Python、Java 和若干平台场景不完整，缺少敏感字段过滤、采样、权限、验证遥测是否到达等端到端步骤，用户仍可能需要较多补充判断。
技能包含代码、CLI、KQL 和一个 Microsoft Learn 链接，仓库也展示通用 CI 和测试基础设施。扣分原因是没有提供该技能路径对应的 acceptance criteria、专门测试或第三方执行结果；仓库级证据不能证明本技能关键路径已独立复现，因此仅给予有限可审计性。
- 使用前应核对实际语言、框架、托管方式与技能前置条件；当前文档存在范围不一致。
- 不要把 Application Insights 连接字符串写入源码、日志或公开命令输出；应补充遥测敏感字段过滤、权限、采样和回滚步骤。
- 应验证引用的 appinsights.ps1、SDK 版本和 Java 迁移路径是否存在且仍受支持，并在部署后确认遥测实际到达。
- Azure Portal、Azure CLI 和外部文档依赖网络与账户权限；材料未说明中国大陆网络可达性或替代路径。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 Azure Application Insights 的参考型 Agent Skill，帮助用户理解 Web 应用插桩、SDK 配置和遥测模式。它指导代理先识别应用的语言、框架与托管方式，再选择自动或手动插桩路径。内容涵盖 ASP.NET Core、Node.js、Python、OpenTelemetry，以及 Azure Container Apps 的可观测性参考。它适合需要方案和示例的开发者，不是专门执行项目修改的部署工具。
读取工作区源代码以推断应用语言、框架和托管方式；根据应用类型推荐自动插桩或手动插桩；引用 ASP.NET Core、Node.js、Python、自动插桩、Container Apps 和 OpenTelemetry SDK 指南；提供将 Application Insights 加入 Bicep 或使用 Azure CLI 创建资源的参考；说明应将资源放入便于管理且与应用资源相同的资源组。
- 在 Azure App Service 上运行 ASP.NET Core 应用、希望了解自动插桩方式的开发者。
- 在 Azure 上托管 Node.js Web 应用、需要 SDK 设置和遥测模式示例的开发者。
- 正在研究如何为现有应用创建 Application Insights 资源并更新代码的工程师。
- 需要了解 Python 或 TypeScript OpenTelemetry 发行版和导出器参考的开发者。
- 在 Azure Container Apps 上部署应用、需要可观测性指导的团队。
这个 Skill 有哪些优点和局限？
- 覆盖 SDK 设置、遥测模式、自动插桩和手动插桩参考。
- 包含 ASP.NET Core、Node.js、Python、TypeScript 和 Java 的相关 OpenTelemetry 参考。
- 明确区分参考指导与实际项目修改流程。
- 采用 MIT 许可证，并由 Microsoft 标注作者和版本 1.1.2。
- Prerequisites 部分明确列出的应用类型只有托管在 Azure 的 ASP.NET Core 和 Node.js，其他语言的适用边界不够清晰。
- 资源创建和代码修改部分依赖仓库内未在提示中展开的参考文件与脚本。
- 源材料未提供此单个 Skill 的测试覆盖结果。
- 它本身不负责实际添加组件；需要修改项目时应转交 azure-prepare。
如何安装这个 Skill？
安装整个集合：运行 npx skills add microsoft/skills，然后在向导中选择需要的技能；技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。也可在 Copilot CLI 中运行 /plugin marketplace add microsoft/skills 和 /plugin install azure-skills@skills。源材料未说明如何仅通过命令行直接安装此单个技能。
如何使用这个 Skill？
可用触发语句：How do I instrument my ASP.NET Core app with Application Insights? 或 Show me App Insights SDK telemetry patterns. 若用户要实际添加或修改组件，应改用 azure-prepare；使用本 Skill 前，应确认应用托管位置。
这个 Skill 与同类方案有什么区别？
源材料明确将本 Skill 与 azure-prepare 区分：本 Skill 用于指导、模式和参考资料，azure-prepare 用于实际添加或修改组件。