为 Azure 托管应用接入 Application…

当需要了解如何用 Azure Application Insights 为 Web 应用做埋点、配置 SDK 或查阅遥测模式时使用。

适用场景

解决思路

1. 先收集上下文信息：确定应用的（编程语言、应用框架、托管方式）三元组，阅读源码做出合理推断，对不确定的地方与用户确认；必须询问用户应用托管在哪里（例如个人电脑、Azure App Service 代码部署、Azure App Service 容器部署、Azure Container App 等）。
2. 如果应用是托管在 Azure App Service 上的 C# ASP.NET Core 应用，优先使用自动埋点，参考 references/auto.md 帮助用户自动完成埋点。
3. 若无法自动埋点，则手动埋点：先创建 AppInsights 资源，再修改应用代码。
4. 创建 AppInsights 资源时，从以下方案中选择适合当前环境的一种：若工作区已有 Bicep 模板，则将 AppInsights 加入现有 Bicep 模板（参考 examples/appinsights.bicep）；否则使用 Azure CLI（参考 scripts/appinsights.ps1 中的命令）。
5. 无论选择哪种创建方式，都建议用户在便于管理资源的、有意义的资源组中创建 App Insights 资源，最佳候选是包含该应用 Azure 托管资源的同一资源组。
6. 修改应用代码：ASP.NET Core 应用参考 references/aspnetcore.md 修改 C# 代码；Node.js 应用参考 references/nodejs.md 修改 JavaScript/TypeScript 代码；Python 应用参考 references/python.md 修改 Python 代码。
7. 查阅 SDK 快速参考：OpenTelemetry Distro 见 Python（references/sdk/azure-monitor-opentelemetry-py.md）与 TypeScript（references/sdk/azure-monitor-opentelemetry-ts.md）；OpenTelemetry Exporter 见 Python（references/sdk/azure-monitor-opentelemetry-exporter-py.md）与 Java（references/sdk/azure-monitor-opentelemetry-exporter-java.md）。
8. 查阅平台专属指南：Container Apps 见 references/container-apps.md 的可观测性指南。
9. 注意：如果用户是想真正给应用添加 App Insights 组件（例如说“给我的应用加遥测”“添加 App Insights”或要修改项目），应改用 azure-prepare 来编排实际改动，本技能只提供参考资料。

适用边界 · 注意事项

• 用户想要实际修改项目、添加或变更组件（如“给我的应用加遥测”“添加 App Insights”）时，应改用 azure-prepare。
• 工作区中的应用不是托管在 Azure 上的 ASP.NET Core 应用或 Node.js 应用时（不满足前置条件）。
• 用户只是询问概念、模式或示例等纯指导性问题时，无需执行创建资源和改代码的操作。