appinsights-instrumentation

AppInsights 检测

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

何时使用此技能

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

先决条件

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

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

指南

收集上下文信息

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

优先使用自动检测

如果应用是托管在 Azure 应用服务中的 C# ASP.NET Core 应用，请使用 自动指南 帮助用户自动检测应用。

手动检测

通过创建 AppInsights 资源并更新应用代码来手动检测应用。

创建 AppInsights 资源

使用以下适合环境的选项之一：

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

无论选择哪个选项，都建议用户在有助于简化资源管理的资源组中创建 Application Insights 资源。一个好的选择是与托管在 Azure 中的应用资源所在的资源组相同。

修改应用程序代码

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