appinsights-instrumentation

AppInsights 插桩

此技能可将 Web 应用的遥测数据发送到 Azure App Insights，以便更好地观测应用的健康状况。

何时使用此技能

当用户希望为其 Web 应用启用遥测时，使用此技能。

先决条件

工作区中的应用必须是以下类型之一

• 托管在 Azure 中的 ASP.NET Core 应用
• 托管在 Azure 中的 Node.js 应用

指南

收集上下文信息

找出用户尝试添加遥测支持的应用的（编程语言、应用框架、托管方式）组合。这决定了如何对该应用进行插桩。阅读源代码以做出合理推测。对于任何不清楚的地方，请与用户确认。你必须始终询问用户应用的托管位置（例如，在个人计算机上、在 Azure App Service 中作为代码、在 Azure App Service 中作为容器、在 Azure Container App 中，等等）。

尽可能优先使用自动插桩

如果应用是托管在 Azure App Service 中的 C# ASP.NET Core 应用，请使用 AUTO 指南帮助用户对应用进行自动插桩。

手动插桩

通过创建 AppInsights 资源并更新应用的代码，对应用进行手动插桩。

创建 AppInsights 资源

使用以下适合当前环境的选项之一。

• 将 AppInsights 添加到现有的 Bicep 模板。有关需要添加的内容，请参阅 examples/appinsights.bicep。如果工作区中已有 Bicep 模板文件，这是最佳选项。
• 使用 Azure CLI。有关要执行哪些 Azure CLI 命令来创建 App Insights 资源，请参阅 scripts/appinsights.ps1。

无论选择哪个选项，都建议用户在有助于更轻松管理资源的有意义的资源组中创建 App Insights 资源。一个合适的选择是包含 Azure 中托管应用资源的同一资源组。

修改应用程序代码

• 如果应用是 ASP.NET Core 应用，请参阅 ASPNETCORE 指南了解如何修改 C# 代码。
• 如果应用是 Node.js 应用，请参阅 NODEJS 指南了解如何修改 JavaScript/TypeScript 代码。
• 如果应用是 Python 应用，请参阅 PYTHON 指南了解如何修改 Python 代码。