name: appinsights-instrumentation
description: 关于使用 Azure Application Insights 对 Web 应用程序进行检测的指南。提供遥测模式、SDK 设置和配置参考。WHEN：如何检测应用、App Insights SDK、遥测模式、什么是 App Insights、Application Insights 指南、检测示例、APM 最佳实践。
license: MIT
metadata:
    author: Microsoft
    version: "1.1.2"

AppInsights 检测指南

此技能提供指导和参考材料，用于使用 Azure Application Insights 检测 Web 应用。

⛔ 需要添加组件？

>

如果用户想要向其应用添加 App Insights，请改为调用 azure-prepare。

此技能提供参考材料——azure-prepare 负责协调实际的更改。

何时使用此技能

• 用户询问如何进行检测（指导、模式、示例）
• 用户需要 SDK 设置说明
• azure-prepare 在研究阶段调用此技能
• 用户想要了解 App Insights 概念

何时改用 azure-prepare

• 用户说“为我的应用添加遥测”
• 用户说“添加 App Insights”
• 用户想要修改其项目
• 任何涉及更改/添加组件的请求

先决条件

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

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

指南

收集上下文信息

查明用户尝试添加遥测支持的应用程序的（编程语言、应用程序框架、托管环境）组合。这决定了应用程序可以被检测的方式。通过阅读源代码进行有根据的猜测。对任何未知信息，向用户确认。你必须始终询问用户应用程序的托管位置（例如，在个人计算机上、在 Azure 应用服务中作为代码运行、在 Azure 应用服务中作为容器运行、在 Azure 容器应用中运行等）。

尽可能首选自动检测

如果应用是托管在 Azure 应用服务中的 C# ASP.NET Core 应用，请使用 [AUTO 指南](references/auto.md) 帮助用户进行自动检测。

手动检测

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

#### 创建 AppInsights 资源

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

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

无论选择哪个选项，建议用户在有意义的资源组中创建 App Insights 资源，以便于管理资源。一个好的候选是与 Azure 中托管应用资源所在的资源组相同。

#### 修改应用程序代码

• 如果应用是 ASP.NET Core 应用，请参阅 [ASPNETCORE 指南](references/aspnetcore.md) 了解如何修改 C# 代码。
• 如果应用是 Node.js 应用，请参阅 [NODEJS 指南](references/nodejs.md) 了解如何修改 JavaScript/TypeScript 代码。
• 如果应用是 Python 应用，请参阅 [PYTHON 指南](references/python.md) 了解如何修改 Python 代码。

SDK 快速参考

• OpenTelemetry 发行版：[Python](references/sdk/azure-monitor-opentelemetry-py.md) | [TypeScript](references/sdk/azure-monitor-opentelemetry-ts.md)
• OpenTelemetry 导出器：[Python](references/sdk/azure-monitor-opentelemetry-exporter-py.md) | [Java](references/sdk/azure-monitor-opentelemetry-exporter-java.md)

平台特定指南

• 容器应用：[可观测性指南](references/container-apps.md)