从 Application Insights SDK 迁移到 Azure Monitor OpenTelemetry

本指南提供将应用程序从使用 Application Insights SDK（经典 API）迁移到 Azure Monitor OpenTelemetry 的分步说明。

预期使用 Azure Monitor OpenTelemetry 监测工具的体验与 Application Insights SDK 类似。有关详细信息和功能比较，请参阅功能的发布状态。

ASP.NET 核心迁移到 Azure Monitor OpenTelemetry 发行版。（Azure.Monitor.OpenTelemetry.AspNetCore NuGet 包）
ASP.NET、控制台和 WorkerService 迁移到 Azure Monitor OpenTelemetry 导出程序。（Azure.Monitor.OpenTelemetry.Exporter NuGet 包）

如果开始使用 Application Insights 且不需要从经典 API 迁移，请参阅 “启用 Azure Monitor OpenTelemetry”。

注释

有关 Azure Function Apps，请参阅将 OpenTelemetry 与 Azure Functions 配合使用。

先决条件

ASP.NET Core

已使用 Application Insights 检测的 ASP.NET Core Web 应用程序，无需进行任何自定义。
.NET的一个主动支持版本。

ASP.NET

已使用 Application Insights 检测的 ASP.NET Web 应用程序。
. NET Framework 的主动支持版本。

Console

已使用 Application Insights 检测的控制台应用程序。
当前受支持的 .NET Framework 或 .NET 版本。

WorkerService

已使用 Application Insights 检测的 WorkerService 应用程序，无需进行任何自定义。
.NET的一个主动支持版本。

小窍门

我们的产品组正在积极寻求有关本文档的反馈。提供反馈给 otel@microsoft.com 或查看支持部分。

删除 Application Insights SDK

注释

在继续执行这些步骤之前，应确认应用程序的当前备份。

ASP.NET Core

删除 NuGet 包

从Microsoft.ApplicationInsights.AspNetCore删除csproj包。
```
dotnet remove package Microsoft.ApplicationInsights.AspNetCore
```
删除初始化代码和自定义项

删除对代码库中 Application Insights 类型的任何引用。

小窍门

删除 Application Insights 包后，可以重新生成应用程序以获取需要删除的引用列表。
- 从您的ServiceCollection中移除 Application Insights，方法是删除以下行：
```
builder.Services.AddApplicationInsightsTelemetry();
```
- 从ApplicationInsights中删除appsettings.json部分。
```
{
    "ApplicationInsights": {
        "ConnectionString": "<YOUR-CONNECTION-STRING>"
    }
}
```
清理和生成

检查 bin 目录，验证是否删除了对 Microsoft.ApplicationInsights.* 的所有引用。
测试应用程序

验证应用程序是否没有意外的后果。

ASP.NET

删除 NuGet 包

从Microsoft.AspNet.TelemetryCorrelation和Microsoft.ApplicationInsights.*中删除csproj包以及任何packages.config包。
删除 ApplicationInsights.config 文件，

从应用程序的 Web.config 文件中删除分区。

首次将 ApplicationInsights 添加到项目时，会自动将两个 HttpModule 添加到 web.config。

应删除对 TelemetryCorrelationHttpModule 和 ApplicationInsightsWebTracking 的任何引用。如果将 Application Insights 添加到 Internet Information Server （IIS）模块，则还应将其删除。

<configuration>
<system.web>
    <httpModules>
    <add name="TelemetryCorrelationHttpModule" type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, Microsoft.AspNet.TelemetryCorrelation" />
    <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
    </httpModules>
</system.web>
<system.webServer>
    <modules>
    <remove name="TelemetryCorrelationHttpModule" />
    <add name="TelemetryCorrelationHttpModule" type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, Microsoft.AspNet.TelemetryCorrelation" preCondition="managedHandler" />
    <remove name="ApplicationInsightsWebTracking" />
    <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" preCondition="managedHandler" />
    </modules>
</system.webServer>
</configuration>

另请查看添加到 web.config 的任何程序集版本重定向。

删除初始化代码和自定义项

删除对代码库中 Application Insights 类型的任何引用。

小窍门

删除 Application Insights 包后，可以重新生成应用程序以获取需要删除的引用列表。
- 删除对TelemetryConfiguration或TelemetryClient的引用。它是应用程序启动的一部分，用于初始化 Application Insights SDK。
- 以下方案是可选的，适用于高级用户。
  - 如果对用于TelemetryClient数据的引用更多，则应删除这些引用。
  - 如果您通过或TelemetryProcessor添加了任何TelemetryInitializer，则应将其删除。可以在您的配置中找到对它们的引用。
  - 如果你的项目在FilterConfig.cs目录中有一个App_Start，请检查引用 Application Insights 的任何自定义异常处理程序并将其删除。
删除 JavaScript 代码片段

如果添加了 JavaScript SDK 以收集客户端遥测数据，也可以将其删除，尽管它在不使用 .NET SDK 的情况下继续工作。有关要删除的内容的完整代码示例，请查看 JavaScript SDK 的载入指南。
删除任何 Visual Studio 工件

如果使用 Visual Studio 载入 Application Insights，则可以在项目中留下更多文件。
- ConnectedService.json 可能与 Application Insights 资源有关联。
- [Your project's name].csproj 可能包含对 Application Insights 资源的引用：
```
<ApplicationInsightsResourceId>/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/Default-ApplicationInsights-ChinaNorth/providers/microsoft.insights/components/WebApplication4</ApplicationInsightsResourceId>
```
清理和生成

检查 bin 目录，验证是否删除了对 Microsoft.ApplicationInsights. 的所有引用。
测试应用程序

验证应用程序是否没有意外的后果。

Console

删除 NuGet 包

从你的Microsoft.ApplicationInsights.*和csproj中删除任何packages.config包。
```
dotnet remove package Microsoft.ApplicationInsights
```
小窍门

如果已使用 Microsoft.ApplicationInsights.WorkerService，请参阅 WorkerService 选项卡。
删除初始化代码和自定义项

删除对代码库中 Application Insights 类型的任何引用。

小窍门

删除 Application Insights 包后，可以重新生成应用程序以获取需要删除的引用列表。
- 删除对TelemetryConfiguration或TelemetryClient的引用。在应用程序启动时，应该初始化 Application Insights SDK。
```
var config = TelemetryConfiguration.CreateDefault();
var client = new TelemetryClient(config);
```
小窍门

如果您使用 AddApplicationInsightsTelemetryWorkerService() 将 Application Insights 添加到你的 ServiceCollection 帐户，请查看 WorkerService 选项卡。
清理和生成

检查 bin 目录，验证是否删除了对 Microsoft.ApplicationInsights. 的所有引用。
测试应用程序

验证应用程序是否没有意外的后果。

WorkerService

删除 NuGet 包

从Microsoft.ApplicationInsights.WorkerService删除csproj包。
```
dotnet remove package Microsoft.ApplicationInsights.WorkerService
```
删除初始化代码和自定义项

删除对代码库中 Application Insights 类型的任何引用。

小窍门

删除 Application Insights 包后，可以重新生成应用程序以获取需要删除的引用列表。
- 从您的ServiceCollection中移除 Application Insights，方法是删除以下行：
```
builder.Services.AddApplicationInsightsTelemetryWorkerService();
```
- 从ApplicationInsights中删除appsettings.json部分。
```
{
    "ApplicationInsights": {
        "ConnectionString": "<YOUR-CONNECTION-STRING>"
    }
}
```
清理和生成

检查 bin 目录，验证是否删除了对 Microsoft.ApplicationInsights.* 的所有引用。
测试应用程序

验证应用程序是否没有意外的后果。

小窍门

我们的产品组正在积极寻求有关本文档的反馈。提供反馈给 otel@microsoft.com 或查看支持部分。

启用 OpenTelemetry

建议按照以下说明创建开发资源并使用其连接字符串。

计划更新连接字符串，以在确认迁移成功后将遥测数据发送到原始资源。

ASP.NET Core

安装 Azure Monitor 发行版

我们的 Azure Monitor 发行版通过包括 OpenTelemetry 检测库来自动遥测，用于收集跟踪、指标、日志和异常，并允许收集自定义遥测。

安装 Azure Monitor 发行版会将 OpenTelemetry SDK 作为依赖项。
```
dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
```
添加和配置 OpenTelemetry 和 Azure Monitor

OpenTelemetry SDK 必须在应用程序启动时配置为你的 ServiceCollection 的一部分，通常在 Program.cs 中。

OpenTelemetry 有三个信号的概念：跟踪、指标和日志。 Azure Monitor 发行版配置其中每个信号。

Program.cs

下面的代码示例演示了基础知识。

using Azure.Monitor.OpenTelemetry.AspNetCore;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        // Call AddOpenTelemetry() to add OpenTelemetry to your ServiceCollection.
        // Call UseAzureMonitor() to fully configure OpenTelemetry.
        builder.Services.AddOpenTelemetry().UseAzureMonitor();

        var app = builder.Build();
        app.MapGet("/", () => "Hello World!");
        app.Run();
    }
}

建议在环境变量中设置连接字符串：

APPLICATIONINSIGHTS_CONNECTION_STRING=<YOUR-CONNECTION-STRING>

此处详细介绍了配置连接字符串的更多选项：配置 Application Insights 连接字符串。

ASP.NET

通过 Azure Monitor 安装 OpenTelemetry SDK

安装 Azure Monitor 导出程序会将 OpenTelemetry SDK 作为依赖项。
```
dotnet add package Azure.Monitor.OpenTelemetry.Exporter
```
将 OpenTelemetry 配置为应用程序启动的一部分

必须在应用程序启动时配置 OpenTelemery SDK，通常位于 Global.asax.cs. OpenTelemetry 有三个信号的概念：跟踪、指标和日志。您的应用程序启动时需要配置每个信号。应为应用程序创建一次TracerProvider、MeterProvider和ILoggerFactory，并在应用程序关闭时释放。

Global.asax.cs

下面的代码示例演示了一个简单的示例，仅用于显示基础知识。此时不会收集任何遥测数据。

using Microsoft.Extensions.Logging;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

public class Global : System.Web.HttpApplication
{
    private TracerProvider? tracerProvider;
    private MeterProvider? meterProvider;
    // The LoggerFactory needs to be accessible from the rest of your application.
    internal static ILoggerFactory loggerFactory;

    protected void Application_Start()
    {
        this.tracerProvider = Sdk.CreateTracerProviderBuilder()
            .Build();

        this.meterProvider = Sdk.CreateMeterProviderBuilder()
            .Build();

        loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry();
        });
    }

    protected void Application_End()
    {
        this.tracerProvider?.Dispose();
        this.meterProvider?.Dispose();
        loggerFactory?.Dispose();
    }
}

Console

通过 Azure Monitor 安装 OpenTelemetry SDK

安装 Azure Monitor 导出程序会将 OpenTelemetry SDK 作为依赖项。
```
dotnet add package Azure.Monitor.OpenTelemetry.Exporter
```
将 OpenTelemetry 配置为应用程序启动的一部分

必须在应用程序启动时配置 OpenTelemery SDK，通常位于 Program.cs. OpenTelemetry 有三个信号的概念：跟踪、指标和日志。您的应用程序启动时需要配置每个信号。应为应用程序创建一次TracerProvider、MeterProvider和ILoggerFactory，并在应用程序关闭时释放。

下面的代码示例演示了一个简单的示例，仅用于显示基础知识。此时不会收集任何遥测数据。

Program.cs

using Microsoft.Extensions.Logging;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

internal class Program
{
    static void Main(string[] args)
    {
        TracerProvider tracerProvider = Sdk.CreateTracerProviderBuilder()
            .Build();

        MeterProvider meterProvider = Sdk.CreateMeterProviderBuilder()
            .Build();

        ILoggerFactory loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry();
        });

        Console.WriteLine("Hello, World!");

        // Dispose tracer provider before the application ends.
        // It will flush the remaining spans and shutdown the tracing pipeline.
        tracerProvider.Dispose();

        // Dispose meter provider before the application ends.
        // It will flush the remaining metrics and shutdown the metrics pipeline.
        meterProvider.Dispose();

        // Dispose logger factory before the application ends.
        // It will flush the remaining logs and shutdown the logging pipeline.
        loggerFactory.Dispose();
    }
}

WorkerService

通过 Azure Monitor 安装 OpenTelemetry SDK

安装 Azure Monitor 导出程序会将 OpenTelemetry SDK 作为依赖项。
```
dotnet add package Azure.Monitor.OpenTelemetry.Exporter
```
还必须安装 OpenTelemetry 扩展托管包。
```
dotnet add package OpenTelemetry.Extensions.Hosting
```
将 OpenTelemetry 配置为应用程序启动的一部分

必须在应用程序启动时配置 OpenTelemery SDK，通常位于 Program.cs. OpenTelemetry 有三个信号的概念：跟踪、指标和日志。您的应用程序启动时需要配置每个信号。应为应用程序创建一次TracerProvider、MeterProvider和ILoggerFactory，并在应用程序关闭时释放。

下面的代码示例演示了一个简单的示例，仅用于显示基础知识。此时不会收集任何遥测数据。

Program.cs

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = Host.CreateApplicationBuilder(args);
        builder.Services.AddHostedService<Worker>();

        builder.Services.AddOpenTelemetry()
            .WithTracing()
            .WithMetrics();

        builder.Logging.AddOpenTelemetry();

        var host = builder.Build();
        host.Run();
    }
}

小窍门

我们的产品组正在积极寻求有关本文档的反馈。提供反馈给 otel@microsoft.com 或查看支持部分。

安装和配置检测库

ASP.NET Core

可以向项目添加检测库，以便自动收集有关特定组件或依赖项的遥测数据。

发行版中包含以下库。

自定义仪器库

Azure Monitor 发行版包括适用于 ASP.NET Core、HttpClient 和 SQLClient 的 .NET OpenTelemetry 探测。可以使用 OpenTelemetry API 自定义这些包含的检测，或自行手动添加额外的检测。

下面是一些关于如何自定义仪器的示例：

自定义 AspNetCoreTraceInstrumentationOptions

builder.Services.AddOpenTelemetry().UseAzureMonitor();
builder.Services.Configure<AspNetCoreTraceInstrumentationOptions>(options =>
{
    options.RecordException = true;
    options.Filter = (httpContext) =>
    {
        // only collect telemetry about HTTP GET requests
        return HttpMethods.IsGet(httpContext.Request.Method);
    };
});

自定义 HttpClientTraceInstrumentationOptions

builder.Services.AddOpenTelemetry().UseAzureMonitor();
builder.Services.Configure<HttpClientTraceInstrumentationOptions>(options =>
{
    options.RecordException = true;
    options.FilterHttpRequestMessage = (httpRequestMessage) =>
    {
        // only collect telemetry about HTTP GET requests
        return HttpMethods.IsGet(httpRequestMessage.Method.Method);
    };
});

自定义 SqlClientInstrumentationOptions

我们在包中提供 SQLClient 工具，与此同时它仍处于 beta 阶段。当它达到稳定版本时，我们会将其作为标准包引用包含在内。在此期间，若要自定义 SQLClient 仪表，请将 OpenTelemetry.Instrumentation.SqlClient 包引用添加到项目中并使用其公共 API。

dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient

builder.Services.AddOpenTelemetry().UseAzureMonitor().WithTracing(builder =>
{
    builder.AddSqlClientInstrumentation(options =>
    {
        options.SetDbStatementForStoredProcedure = false;
    });
});

ASP.NET

可以向项目添加检测库，以便自动收集有关特定组件或依赖项的遥测数据。建议使用以下库：

OpenTelemetry.Instrumentation.AspNet 可用于收集传入请求的遥测数据。 Azure Monitor 将其映射到请求遥测。

dotnet add package OpenTelemetry.Instrumentation.AspNet

您需要在 Web.config 中添加一个额外的 HttpModule。

<system.webServer>
  <modules>
      <add
          name="TelemetryHttpModule"
          type="OpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule,
              OpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule"
          preCondition="integratedMode,managedHandler" />
  </modules>
</system.webServer>

此处提供了完整的入门指南： OpenTelemetry.Instrumentation.AspNet 自述文件

OpenTelemetry.Instrumentation.Http 可用于收集出站 http 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package OpenTelemetry.Instrumentation.Http
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.Http README
OpenTelemetry.Instrumentation.SqlClient 可用于收集 MS SQL 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.SqlClient 自述文件

Global.asax.cs

下面的代码示例扩展了上一个示例。它现在收集遥测数据，但尚未发送到 Application Insights。

using Microsoft.Extensions.Logging;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

public class Global : System.Web.HttpApplication
{
    private TracerProvider? tracerProvider;
    private MeterProvider? meterProvider;
    internal static ILoggerFactory loggerFactory;

    protected void Application_Start()
    {
        this.tracerProvider = Sdk.CreateTracerProviderBuilder()
            .AddAspNetInstrumentation()
            .AddHttpClientInstrumentation()
            .AddSqlClientInstrumentation()
            .Build();

        this.meterProvider = Sdk.CreateMeterProviderBuilder()
            .AddAspNetInstrumentation()
            .AddHttpClientInstrumentation()
            .Build();

        loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry();
        });
    }

    protected void Application_End()
    {
        this.tracerProvider?.Dispose();
        this.meterProvider?.Dispose();
        loggerFactory?.Dispose();
    }
}

Console

可以向项目添加检测库，以便自动收集有关特定组件或依赖项的遥测数据。建议使用以下库：

OpenTelemetry.Instrumentation.Http 可用于收集出站 http 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package OpenTelemetry.Instrumentation.Http
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.Http README
OpenTelemetry.Instrumentation.SqlClient 可用于收集 MS SQL 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.SqlClient 自述文件

下面的代码示例扩展了上一个示例。它现在收集遥测数据，但尚未发送到 Application Insights。

Program.cs

using Microsoft.Extensions.Logging;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

internal class Program
{
    static void Main(string[] args)
    {
        TracerProvider tracerProvider = Sdk.CreateTracerProviderBuilder()
            .AddHttpClientInstrumentation()
            .AddSqlClientInstrumentation()
            .Build();

        MeterProvider meterProvider = Sdk.CreateMeterProviderBuilder()
            .AddHttpClientInstrumentation()
            .Build();

        ILoggerFactory loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry();
        });

        Console.WriteLine("Hello, World!");

        tracerProvider.Dispose();
        meterProvider.Dispose();
        loggerFactory.Dispose();
    }
}

WorkerService

可以向项目添加检测库，以便自动收集有关特定组件或依赖项的遥测数据。建议使用以下库：

OpenTelemetry.Instrumentation.Http 可用于收集出站 http 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package OpenTelemetry.Instrumentation.Http
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.Http README
OpenTelemetry.Instrumentation.SqlClient 可用于收集 MS SQL 依赖项的遥测数据。 Azure Monitor 将其映射到依赖项遥测。
```
dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
```
此处提供了完整的入门指南： OpenTelemetry.Instrumentation.SqlClient 自述文件

下面的代码示例扩展了上一个示例。它现在收集遥测数据，但尚未发送到 Application Insights。

Program.cs

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = Host.CreateApplicationBuilder(args);
        builder.Services.AddHostedService<Worker>();

        builder.Services.AddOpenTelemetry()
            .WithTracing(builder =>
            {
                builder.AddHttpClientInstrumentation();
                builder.AddSqlClientInstrumentation();
            })
            .WithMetrics(builder =>
            {
                builder.AddHttpClientInstrumentation();
            });

        builder.Logging.AddOpenTelemetry();

        var host = builder.Build();
        host.Run();
    }
}

配置 Azure Monitor

ASP.NET Core

Application Insights 通过 ApplicationInsightsServiceOptions提供更多配置选项。

Application Insights 设置	OpenTelemetry 替代项
AddAutoCollectedMetricExtractor	N/A
应用程序版本	在资源上设置“service.version”
ConnectionString	请参阅有关配置连接字符串的说明。
依赖项收集选项	N/A. 若要自定义依赖项，请查看适用于检测库的可用配置选项。
DeveloperMode	N/A
EnableActiveTelemetryConfigurationSetup	N/A
启用自适应采样	N/A. 仅支持固定速率采样。
启用应用服务心跳遥测模块	N/A
EnableAuthenticationTrackingJavaScript	N/A
启用Azure实例元数据遥测模块	N/A
启用依赖追踪遥测模块	请参阅有关筛选跟踪的说明。
启用诊断遥测模块	N/A
启用事件计数器集合模块 (EnableEventCounterCollectionModule)	N/A
EnableHeartbeat	N/A
EnablePerformanceCounterCollectionModule	N/A
EnableQuickPulseMetricStream	AzureMonitorOptions.EnableLiveMetrics
启用请求跟踪遥测模块 (EnableRequestTrackingTelemetryModule)	请参阅有关筛选跟踪的说明。
端点地址	使用 ConnectionString。
InstrumentationKey	使用 ConnectionString。
请求收集选项	N/A. 请参阅 OpenTelemetry.Instrumentation.AspNetCore 选项。

删除自定义配置

以下方案是可选的，仅适用于高级用户。

如果还有对的引用，这些引用可用于手动记录遥测数据，那么应将其删除。

如果您通过或TelemetryProcessor添加了任何TelemetryInitializer，则应将其删除。可以在你的 ServiceCollection中找到它们。

builder.Services.AddSingleton<ITelemetryInitializer, MyCustomTelemetryInitializer>();

builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();

删除 JavaScript 代码片段

如果使用 Application Insights .NET SDK 提供的代码片段，则还必须将其删除。有关要删除的内容的完整代码示例，请查看本指南，为 Web 应用程序启用客户端遥测。

如果添加了 JavaScript SDK 以收集客户端遥测数据，也可以将其删除，尽管它在不使用 .NET SDK 的情况下继续工作。有关要删除的内容的完整代码示例，请查看 JavaScript SDK 的载入指南。
删除任何 Visual Studio 工件

如果使用 Visual Studio 载入 Application Insights，则可以在项目中留下更多文件。
- Properties/ServiceDependencies 目录可能包含对 Application Insights 资源的引用。

ASP.NET

若要将遥测数据发送到 Application Insights，必须将 Azure Monitor 导出程序添加到所有三个信号的配置中。

Global.asax.cs

下面的代码示例扩展了上一个示例。它现在收集遥测数据并将其发送到 Application Insights。

public class Global : System.Web.HttpApplication
{
    private TracerProvider? tracerProvider;
    private MeterProvider? meterProvider;
    internal static ILoggerFactory loggerFactory;

    protected void Application_Start()
    {
        this.tracerProvider = Sdk.CreateTracerProviderBuilder()
            .AddAspNetInstrumentation()
            .AddHttpClientInstrumentation()
            .AddSqlClientInstrumentation()
            .AddAzureMonitorTraceExporter()
            .Build();

        this.meterProvider = Sdk.CreateMeterProviderBuilder()
            .AddAspNetInstrumentation()
            .AddHttpClientInstrumentation()
            .AddAzureMonitorMetricExporter()
            .Build();

        loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry(logging => logging.AddAzureMonitorLogExporter());
        });
    }

    protected void Application_End()
    {
        this.tracerProvider?.Dispose();
        this.meterProvider?.Dispose();
        loggerFactory?.Dispose();
    }
}

建议在环境变量中设置连接字符串：

APPLICATIONINSIGHTS_CONNECTION_STRING=<YOUR-CONNECTION-STRING>

此处详细介绍了配置连接字符串的更多选项：配置 Application Insights 连接字符串。

Console

若要将遥测数据发送到 Application Insights，必须将 Azure Monitor 导出程序添加到所有三个信号的配置中。

Program.cs

下面的代码示例扩展了上一个示例。它现在收集遥测数据并将其发送到 Application Insights。

using Microsoft.Extensions.Logging;
using OpenTelemetry;
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

internal class Program
{
    static void Main(string[] args)
    {
        TracerProvider tracerProvider = Sdk.CreateTracerProviderBuilder()
            .AddHttpClientInstrumentation()
            .AddSqlClientInstrumentation()
            .AddAzureMonitorTraceExporter()
            .Build();

        MeterProvider meterProvider = Sdk.CreateMeterProviderBuilder()
            .AddHttpClientInstrumentation()
            .AddAzureMonitorMetricExporter()
            .Build();

        ILoggerFactory loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddOpenTelemetry(logging => logging.AddAzureMonitorLogExporter());
        });

        Console.WriteLine("Hello, World!");

        tracerProvider.Dispose();
        meterProvider.Dispose();
        loggerFactory.Dispose();
    }
}

建议在环境变量中设置连接字符串：

APPLICATIONINSIGHTS_CONNECTION_STRING=<YOUR-CONNECTION-STRING>

此处详细介绍了配置连接字符串的更多选项：配置 Application Insights 连接字符串。

删除自定义配置

以下方案是可选的，适用于高级用户。

如果你还有更多对TelemetryClient的引用（该引用用于手动记录遥测），应将其删除。
删除通过自定义添加的任何筛选或扩充。配置引用它们。
删除任何 Visual Studio 工件

如果使用 Visual Studio 载入 Application Insights，则可以在项目中留下更多文件。
- ConnectedService.json 可能与 Application Insights 资源有关联。
- [Your project's name].csproj 可能包含对 Application Insights 资源的引用：
```
<ApplicationInsightsResourceId>/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/Default-ApplicationInsights-ChinaNorth/providers/microsoft.insights/components/WebApplication4</ApplicationInsightsResourceId>
```

WorkerService

若要将遥测数据发送到 Application Insights，必须将 Azure Monitor 导出程序添加到所有三个信号的配置中。

Program.cs

下面的代码示例扩展了上一个示例。它现在收集遥测数据并将其发送到 Application Insights。

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = Host.CreateApplicationBuilder(args);
        builder.Services.AddHostedService<Worker>();

        builder.Services.AddOpenTelemetry()
            .WithTracing(builder =>
            {
                builder.AddHttpClientInstrumentation();
                builder.AddSqlClientInstrumentation();
                builder.AddAzureMonitorTraceExporter();
            })
            .WithMetrics(builder =>
            {
                builder.AddHttpClientInstrumentation();
                builder.AddAzureMonitorMetricExporter();
            });

        builder.Logging.AddOpenTelemetry(logging => logging.AddAzureMonitorLogExporter());

        var host = builder.Build();
        host.Run();
    }
}

建议在环境变量中设置连接字符串：

APPLICATIONINSIGHTS_CONNECTION_STRING=<YOUR-CONNECTION-STRING>

此处详细介绍了配置连接字符串的更多选项：配置 Application Insights 连接字符串。

删除自定义配置

以下方案是可选的，适用于高级用户。

如果对用于TelemetryClient数据的引用更多，则应删除这些引用。
如果在自定义筛选或增强方面添加了任何自定义TelemetryProcessor或TelemetryInitializer，则应将其删除。可以在你的 ServiceCollection中查找参考。
```
builder.Services.AddSingleton<ITelemetryInitializer, MyCustomTelemetryInitializer>();
```
```
builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();
```
删除任何 Visual Studio 工件

如果使用 Visual Studio 载入 Application Insights，则可以在项目中留下更多文件。
- Properties/ServiceDependencies 目录可能包含对 Application Insights 资源的引用。

小窍门

我们的产品组正在积极寻求有关本文档的反馈。提供反馈给 otel@microsoft.com 或查看支持部分。

后续步骤

若要查看常见问题解答 (FAQ)，请参阅从 .NET Application Insights SDK 迁移到 Azure Monitor OpenTelemetry 的常见问题解答
OpenTelemetry SDK 入门指南
OpenTelemetry ASP.NET Core 项目的示例
C# 和 .NET 日志记录
Azure Monitor OpenTelemetry ASP.NET Core 入门

示例项目

小窍门

我们的产品组正在积极寻求有关本文档的反馈。提供反馈给 otel@microsoft.com 或查看支持部分。

Support

如有 Azure 支持方面的问题，请提交 Azure 支持工单。
有关 OpenTelemetry 问题，请直接与 OpenTelemetry .NET 社区联系。
有关与 Azure Monitor 导出程序相关的未解决问题列表，请参阅 GitHub 问题页。

升级到 3.x 时，通常没有任何代码更改。 3.x SDK 依赖项是 2.x SDK 依赖项的无操作（no-op）API 版本。但是，与 3.x Java 代理一起使用时，3.x Java 代理会为其提供实现。因此，您的自定义监测与 3.x Java 代理所提供的所有新自动监测相互关联。

步骤 1：更新依赖项

2.x 依赖项	Action	注解
`applicationinsights-core`	将版本更新到 `3.4.3` 或更高版本
`applicationinsights-web`	将版本更新到 `3.4.3` 或更高版本，并删除 Application Insights Web 筛选器 `web.xml` 文件。
`applicationinsights-web-auto`	替换为 `3.4.3` 或更高版本的 `applicationinsights-web`
`applicationinsights-logging-log4j1_2`	删除依赖项，并从 Log4j 配置中删除 Application Insights 追加器。	在 3.x Java 代理中，Log4j 1.2 会自动完成插桩，因此不再需要手动操作。
`applicationinsights-logging-log4j2`	删除依赖项，并从 Log4j 配置中删除 Application Insights 追加器。	不再需要，因为在 3.x Java 代理中会自动检测 Log4j 2。
`applicationinsights-logging-logback`	删除依赖项，并从 Logback 配置中删除 Application Insights 追加器。	由于 Logback 在 3.x Java 代理中已自动集成，因此不再需要。
`applicationinsights-spring-boot-starter`	替换为 `3.4.3` 或更高版本的 `applicationinsights-web`	云角色名称不再默认为 `spring.application.name`。若要了解如何配置云角色名称，请参阅 3.x 配置文档。

步骤 2：添加 3.x Java 代理

将 3.x Java 代理添加到 Java 虚拟机（JVM）命令行参数，例如：

-javaagent:path/to/applicationinsights-agent-3.7.5.jar

如果您正在使用 Application Insights 2.x Java 代理，只需将现有的 -javaagent:... 替换为前面的示例中的内容。

注释

如果你使用的是 spring-boot-starter，并且如果你愿意，还有一种不使用 Java 代理的替代方案。请参阅 3.x Spring Boot。

步骤 3：配置 Application Insights 连接字符串

请参阅配置连接字符串。

其他说明

本文档的其余部分介绍了从 2.x 升级到 3.x 时可能会遇到的限制和更改，以及一些可能有帮助的解决方法。

TelemetryInitializers

使用 3.x 代理时，2.x SDK TelemetryInitializers 不会运行。许多以前需要编写 A TelemetryInitializer 的用例可以通过配置自定义维度或使用继承的属性在 Application Insights Java 3.x 中解决。

TelemetryProcessors

使用 3.x 代理时，2.x SDK TelemetryProcessors 不会运行。许多以前需要编写 a TelemetryProcessor 的用例可以通过配置采样替代在 Application Insights Java 3.x 中解决。

单个 JVM 中的多个应用程序

Application Insights Java 3.x 使用云角色名称替代（预览版）和/或连接字符串替代（预览版）支持此用例。

操作名称

在 Application Insights Java 2.x SDK 中，在某些情况下，操作名称包含完整路径，例如：

显示操作名称及其完整路径的屏幕截图

Application Insights Java 3.x 中的操作名称已更改，从而在 Application Insights 门户 U/X 中普遍提供更好的聚合视图，例如：

截图显示参数化的操作名称

但是，对于某些应用程序，你可能仍然更喜欢以前操作名称下的 U/X 聚合视图。在这种情况下，可以使用 3.x 中的遥测处理器（预览）功能复制以前的行为。

以下代码片段配置三个遥测处理器，这些处理器合并以复制以前的行为。遥测处理器执行以下作（按顺序）：

第一个遥测处理器是一个属性处理器（类型为 attribute），这意味着它适用于所有具有属性的遥测（当前包括 requests 和 dependencies，并且不久也将包括 traces）。

它匹配任何具有名为http.request.method和url.path的属性的遥测数据。

然后将url.path属性提取为新属性，并命名为tempName。
第二个遥测处理器是范围处理器（具有类型 span），这意味着它适用于 requests 和 dependencies。

它匹配任何具有属性名为tempPath的区段。

然后，它会从属性 tempPath更新范围名称。
最后一个遥测处理器是属性处理器，与第一个遥测处理器的类型相同。

它与任何具有名为tempPath属性的遥测匹配。

然后，它会删除命名 tempPath的属性，并且该属性显示为自定义维度。

{
  "preview": {
    "processors": [
      {
        "type": "attribute",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "http.request.method" },
            { "key": "url.path" }
          ]
        },
        "actions": [
          {
            "key": "url.path",
            "pattern": "https?://[^/]+(?<tempPath>/[^?]*)",
            "action": "extract"
          }
        ]
      },
      {
        "type": "span",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "tempPath" }
          ]
        },
        "name": {
          "fromAttributes": [ "http.request.method", "tempPath" ],
          "separator": " "
        }
      },
      {
        "type": "attribute",
        "include": {
          "matchType": "strict",
          "attributes": [
            { "key": "tempPath" }
          ]
        },
        "actions": [
          { "key": "tempPath", "action": "delete" }
        ]
      }
    ]
  }
}

采样和日志丢失

默认情况下，从 3.4 代理开始启用速率限制采样，这可能会导致意外丢失的日志。

项目示例

此 Java 2.x SDK 项目使用 3.x Java 代理迁移到新项目。

本指南提供了两个选项，用于从 Application Insights Node.js SDK 2.X 升级到 OpenTelemetry。

全新安装 Node.js Azure Monitor OpenTelemetry Distro。
- 删除 Application Insights 经典 API 的依赖项。
- 熟悉 OpenTelemetry API 和术语。
- 做好准备，以利用 OpenTelemetry 现在和未来提供的所有功能。
升级到 Node.js SDK 3.X。
- 推迟代码更改，同时保持与现有自定义事件和指标的兼容性。
- 访问更丰富的 OpenTelemetry 检测库。
- 确保获得最新的安全和漏洞修复资格。

注释

有关 Azure Function Apps，请参阅将 OpenTelemetry 与 Azure Functions 配合使用。

全新安装

获取 OpenTelemetry JavaScript 应用程序编程接口 (API) 和软件开发工具包 (SDK) 的必备知识。
- 阅读 OpenTelemetry JavaScript 文档。
- 查看有关配置 Azure Monitor OpenTelemetry 的信息。
- 评估添加、修改和筛选 OpenTelemetry。
从项目中卸载 applicationinsights 依赖项。
```
npm uninstall applicationinsights
```
从代码中删除 SDK 2.X 实现。

从代码中删除所有 Application Insights 工具。删除在其中初始化、修改或调用 Application Insights 客户端的所有部分。
使用 Azure Monitor OpenTelemetry Distro 启用 Application Insights。

重要

在导入任何其他内容之前，必须调用 useAzureMonitor。如果首先导入其他库，则可能会丢失遥测数据。按照入门加入 Azure Monitor OpenTelemetry Distro。

Azure Monitor OpenTelemetry 发行版的更改和限制

Application Insights SDK 2.X 中的 API 在 Azure Monitor OpenTelemetry Distro 中不可用。虽然 Application Insights SDK 3.X 为遥测引入（如自定义事件和指标）提供了非中断性升级路径，但大多数 SDK 2.X API 不受支持，并且需要对基于 OpenTelemetry 的 API 进行代码更改。
尚不支持按作名称筛选依赖项、日志和异常。

Upgrade

升级 applicationinsights 包依赖项。
```
npm update applicationinsights
```
重新生成应用程序。
测试应用程序。

若要避免在 Application Insights SDK 3.X 中使用不受支持的配置选项，请参阅不受支持的属性。

如果 SDK 在主版本更改后记录了有关不支持使用 API 的警告，而你需要相关的功能，请继续使用 Application Insights SDK 2.X。

更改和限制

以下更改和限制适用于这两条升级路径。

Node.js 版本支持

要使 ApplicationInsights 3.X SDK 支持 Node.js 版本，它必须受到 Azure SDK 和 OpenTelemetry 的重叠支持。请查看 OpenTelemetry 支持的运行时以获取最新更新。使用 Node 8 等旧版本（之前受 ApplicationInsights SDK 支持）的用户仍可以使用 OpenTelemetry 解决方案，但可能会遇到意外或中断性的行为。 ApplicationInsights SDK 还依赖于适用于 JS 的 Azure SDK，它不能保证对已到达生命周期结束的任何 Node.js 版本的支持。请参阅适用于 JS 的 Azure SDK 支持策略。要使 ApplicationInsights 3.X SDK 支持 Node.js 版本，它必须受到 Azure SDK 和 OpenTelemetry 的重叠支持。

配置选项

Application Insights SDK 版本 2.X 提供了在 Azure Monitor OpenTelemetry Distro 或 Application Insights SDK 3.X 主版本升级中不可用的配置选项。若要查找这些更改以及我们仍然支持的选项，请参阅 SDK 配置文档。

扩展指标

Application Insights SDK 2.X 支持扩展指标；但是，对这些指标的支持将在 ApplicationInsights SDK 3.X 版和 Azure Monitor OpenTelemetry Distro 中结束。

遥测处理器

虽然 Azure Monitor OpenTelemetry Distro 和 Application Insights SDK 3.X 不支持 TelemetryProcessors，但它们确实允许你传递范围和日志记录处理器。有关操作方法的详细信息，请参阅 Azure Monitor OpenTelemetry Distro 项目。

此示例演示的操作等同于创建并应用一个在 Application Insights SDK 2.X 中附加自定义属性的遥测处理器。

const applicationInsights = require("applicationinsights");
applicationInsights.setup("YOUR_CONNECTION_STRING");
applicationInsights.defaultClient.addTelemetryProcessor(addCustomProperty);
applicationInsights.start();

function addCustomProperty(envelope: EnvelopeTelemetry) {
    const data = envelope.data.baseData;
    if (data?.properties) {
        data.properties.customProperty = "Custom Property Value";
    }
    return true;
}

此示例演示如何修改 Azure Monitor OpenTelemetry Distro 实现，以将 SpanProcessor 传递给 Distro 的配置。

import { Context, Span} from "@opentelemetry/api";
import { ReadableSpan, SpanProcessor } from "@opentelemetry/sdk-trace-base";
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

class SpanEnrichingProcessor implements SpanProcessor {
    forceFlush(): Promise<void> {
        return Promise.resolve();
    }
    onStart(span: Span, parentContext: Context): void {
        return;
    }
    onEnd(span: ReadableSpan): void {
        span.attributes["custom-attribute"] = "custom-value";
    }
    shutdown(): Promise<void> {
        return Promise.resolve();
    }
}

const options = {
    azureMonitorExporterOptions: {
        connectionString: "YOUR_CONNECTION_STRING"
    },
    spanProcessors: [new SpanEnrichingProcessor()],
};
useAzureMonitor(options);

注释

有关 Azure Function Apps，请参阅将 OpenTelemetry 与 Azure Functions 配合使用。

OpenCensus Python SDK 已停用。

按照以下步骤将 Python 应用程序迁移到 Azure Monitor OpenTelemetry 发行版。

警告

OpenCensus“如何迁移到 OpenTelemetry”博客不适用于 Azure Monitor 用户。
Microsoft不推荐或支持OpenTelemetry OpenCensus 适配层。
下面概述了适用于 Azure Monitor 客户的唯一迁移计划。

步骤 1：卸载 OpenCensus 库

卸载与 OpenCensus 相关的所有库，包括以opencensus-*开头的所有 Pypi 包。

pip freeze | grep opencensus | xargs pip uninstall -y

步骤 2：从代码中删除 OpenCensus

从代码中删除 OpenCensus SDK 和 Azure Monitor OpenCensus 导出程序的所有实例。

检查以opencensus开头的导入语句，以查找必须删除的所有集成、导出者和 OpenCensus API/SDK 实例。

下面是必须删除的导入语句的示例。

from opencensus.ext.azure import metrics_exporter
from opencensus.stats import aggregation as aggregation_module
from opencensus.stats import measure as measure_module

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

from opencensus.ext.azure.log_exporter import AzureLogHandler

步骤 3：熟悉 OpenTelemetry Python API/SDK

以下文档提供了 OpenTelemetry Python API/SDK 的先决条件知识。

OpenTelemetry Python 文档
有关配置和遥测的 Azure Monitor 发行版文档

注释

OpenTelemetry Python 和 OpenCensus Python 具有不同的 API 图面、自动收集功能和载入说明。

步骤 4：设置 Azure Monitor OpenTelemetry 发行版

按照入门页面载入 Azure Monitor OpenTelemetry 发行版。

更改和限制

从 OpenCensus 迁移到 OpenTelemetry 时，可能会遇到以下更改和限制。

Python < 3.7 支持

OpenTelemetry 的基于 Python 的监视解决方案仅支持 Python 3.7 及更高版本，但 OpenCensus 中之前受支持的 Python 版本 2.7、3.4、3.5 和 3.6 除外。建议为使用较旧版本的 Python 的用户进行升级，因为截至撰写本文档时，这些版本的生命周期已结束。坚持不升级的用户可能仍会使用 OpenTelemetry 解决方案，但可能会发现不受支持的意外或中断行为。在任何情况下，opencensus-ext-azure的最后受支持版本始终存在，对这些版本仍然有效，但不会为该项目发布新版本。

配置

OpenCensus Python 提供了一些与遥测收集和导出相关的配置选项。通过使用OpenTelemetry Python API 和 SDK，可以实现相同配置等目标。 OpenTelemetry Azure monitor Python 发行版更适合 Python 应用程序最常见的监视需求。由于发行版封装了 OpenTelemetry API/SDk，因此发行版目前可能不支持一些不常见用例的配置。相反，可以选择载入Azure monitor OpenTelemetry 导出程序，其与 OpenTelemetry API/SDK 结合使用应能够满足监视需求。其中一些配置包括：

自定义传播器
自定义采样器
添加额外的范围/日志处理器/指标读取器

Azure Functions 的内聚性

为了为在 Azure 函数中调用其他 Python 应用程序的 Python 应用程序提供分布式跟踪功能，提供了包opencensus-extension-azure-functions以允许连接的分布式图形。

目前，适用于 Azure Monitor 的 OpenTelemetry 解决方案不支持此方案。作为一种解决方法，可以在 Azure Functions 应用程序中手动传播跟踪上下文，如以下示例所示。

from opentelemetry.context import attach, detach
from opentelemetry.trace.propagation.tracecontext import \
  TraceContextTextMapPropagator

# Context parameter is provided for the body of the function
def main(req, context):
  functions_current_context = {
    "traceparent": context.trace_context.Traceparent,
    "tracestate": context.trace_context.Tracestate
  }
  parent_context = TraceContextTextMapPropagator().extract(
      carrier=functions_current_context
  )
  token = attach(parent_context)

  ...
  # Function logic
  ...
  detach(token)

扩展和导出程序

OpenCensus SDK 提供了通过 OpenCensus 集成和导出器分别收集和导出遥测的方法。在 OpenTelemetry 中，集成现在称为检测，而导出程序则保留相同的术语。 OpenTelemetry Python 检测和导出程序是 OpenCensus 中提供的超集，因此，就库覆盖范围和功能而言，OpenTelemetry 库是直接升级。至于 Azure Monitor OpenTelemetry 发行版，它附带一些现成的常用 OpenTelemetry Python 检测，因此无需额外代码。 Microsoft 完全支持这些检测。

对于此列表中未包含的其他 OpenTelemetry Python 检测，用户仍可能手动检测它们。但是，必须注意，在这些情况下无法保证或支持稳定性和行为。因此，请自行决定使用它们。

如果你想要建议将某个社区检测库加入我们的发行版，请在我们的反馈社区中发帖阐述想法或投票赞成。对于导出程序，Azure Monitor OpenTelemetry 发行版与Azure Monitor OpenTelemetry 导出程序捆绑在一起。如果还想使用其他导出程序，可以将其与发行版中结合使用，如以下示例所示。

TelemetryProcessors

OpenTelemetry 世界中没有 TelemetryProcessors 的概念，但可以使用 API 和类来复制相同的行为。

设置云角色名称和云角色实例

按照此处的说明操作，了解如何为遥测设置云角色名称和云角色实例。 OpenTelemetry Azure Monitor 发行版自动从环境变量中提取值并填充相应的字段。

使用 SpanProcessors 修改范围

即将推出。

使用视图修改指标

即将推出。

性能计数器

OpenCensus Python Azure Monitor 导出程序自动收集称为性能计数器的系统和性能相关指标。这些指标显示在 Application Insights 实例的performanceCounters中。在 OpenTelemetry 中，我们不再将这些指标显式发送到performanceCounters。可以在标准指标下找到与传入/传出请求相关的指标。如果希望 OpenTelemetry 自动收集系统相关指标，可以使用 OpenTelemetry Python 社区提供的实验性系统指标检测。此包是实验性的，不受 Microsoft 的正式支持。

Support

若要查看故障排除步骤、支持选项或者提供 OpenTelemetry 反馈，请参阅针对 Azure Monitor Application Insights 的 OpenTelemetry 故障排除、支持和反馈。

Last updated on 2026-02-13

通过

从 Application Insights SDK 迁移到 Azure Monitor OpenTelemetry

先决条件

ASP.NET Core

ASP.NET

Console

WorkerService

删除 Application Insights SDK

ASP.NET Core

ASP.NET

Console

WorkerService

启用 OpenTelemetry

ASP.NET Core

Program.cs

ASP.NET

Global.asax.cs

Console

Program.cs

WorkerService

Program.cs

安装和配置检测库

ASP.NET Core

自定义仪器库

自定义 AspNetCoreTraceInstrumentationOptions

自定义 HttpClientTraceInstrumentationOptions

自定义 SqlClientInstrumentationOptions

ASP.NET

Global.asax.cs

Console

Program.cs

WorkerService

Program.cs

配置 Azure Monitor

ASP.NET Core

删除自定义配置

ASP.NET

Global.asax.cs

Console

Program.cs

删除自定义配置

WorkerService

Program.cs

更多配置

删除自定义配置

后续步骤

示例项目

Support

其他资源