.NET Application Insights SDK에서 Azure Monitor OpenTelemetry로 마이그레이션

• 사용자 지정 없이 Application Insights로 이미 계측된 ASP.NET Core 웹 애플리케이션
• 적극적으로 지원되는 .NET 버전

• Application Insights로 이미 계측된 ASP.NET 웹 애플리케이션
• 적극적으로 지원되는 .NET Framework 버전

• Application Insights로 이미 계측된 콘솔 애플리케이션
• 적극적으로 지원되는 .NET Framework 버전 또는 .NET

• 사용자 지정 없이 Application Insights로 이미 계측된 WorkerService 웹 애플리케이션
• 적극적으로 지원되는 .NET 버전

1. NuGet 패키지 제거

   csproj에서 Microsoft.ApplicationInsights.AspNetCore 패키지를 제거합니다.

   dotnet remove package Microsoft.ApplicationInsights.AspNetCore
   

2. 초기화 코드 및 사용자 지정 제거

   코드베이스에서 Application Insights 형식에 대한 참조를 제거합니다.

   팁

   Application Insights 패키지를 제거한 후 애플리케이션을 다시 빌드하여 제거해야 하는 참조 목록을 가져올 수 있습니다.

   • 다음 줄을 삭제하여 ServiceCollection에서 Application Insights를 제거합니다.

     builder.Services.AddApplicationInsightsTelemetry();
     

   • appsettings.json에서 ApplicationInsights 섹션을 제거합니다.

     {
         "ApplicationInsights": {
             "ConnectionString": "<Your Connection String>"
         }
     }
     

3. 정리 및 빌드

   bin 디렉터리를 검사하여 Microsoft.ApplicationInsights.*에 대한 모든 참조가 제거되었는지 확인합니다.

4. 애플리케이션 테스트

   애플리케이션에 예기치 않은 결과가 없는지 확인합니다.

1. NuGet 패키지 제거

   csproj 및 packages.config에서 Microsoft.AspNet.TelemetryCorrelation 패키지 및 모든 Microsoft.ApplicationInsights.* 패키지를 제거합니다.

2. ApplicationInsights.config 파일 삭제

3. 애플리케이션의 Web.config 파일에서 섹션 삭제

   • 프로젝트에 ApplicationInsights를 처음 추가했을 때 두 개의 HttpModules가 web.config에 자동으로 추가되었습니다. TelemetryCorrelationHttpModule 및 ApplicationInsightsWebTracking의 참조를 제거해야 합니다. IIS(인터넷 정보 서버) 모듈에 Application Insights를 추가한 경우 제거해야 합니다.

     <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에 추가된 어셈블리 버전 리디렉션도 검토합니다.

4. 초기화 코드 및 사용자 지정 제거

   코드베이스에서 Application Insights 형식에 대한 참조를 제거합니다.

   팁

   Application Insights 패키지를 제거한 후 애플리케이션을 다시 빌드하여 제거해야 하는 참조 목록을 가져올 수 있습니다.

   • TelemetryConfiguration 또는 TelemetryClient에 대한 참조를 제거합니다. Application Insights SDK를 초기화하는 것은 애플리케이션 시작의 일부입니다.

   다음 시나리오는 선택 사항이며 고급 사용자에게 적용됩니다.

   • 원격 분석을 수동으로 기록하는 데 사용되는 TelemetryClient에 대한 참조가 더 있는 경우 제거해야 합니다.
   • 사용자 지정 필터링 또는 보강을 사용자 지정TelemetryProcessor 또는 TelemetryInitializer 형식으로 추가한 경우 제거해야 합니다. 구성에서 참조된 항목을 찾을 수 있습니다.
   • 프로젝트의 App_Start 디렉터리에 FilterConfig.cs가 있는 경우 Application Insights를 참조하고 제거하는 사용자 지정 예외 처리기를 확인합니다.

5. JavaScript 코드 조각 제거

   클라이언트 쪽 원격 분석을 수집하기 위해 JavaScript SDK를 추가한 경우 이는 .NET SDK 없이 계속 작동하지만 제거할 수도 있습니다. 제거할 항목에 대한 전체 코드 샘플은 JavaScript SDK에 대한 온보딩 가이드를 검토하세요.

6. Visual Studio Artifacts 제거

   Visual Studio를 사용하여 Application Insights에 온보딩한 경우 프로젝트에 남은 파일이 더 많을 수 있습니다.

   • ConnectedService.json에는 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

   • [Your project's name].csproj에는 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

     <ApplicationInsightsResourceId>/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/Default-ApplicationInsights-EastUS/providers/microsoft.insights/components/WebApplication4</ApplicationInsightsResourceId>
     

7. 정리 및 빌드

   bin 디렉터리를 검사하여 Microsoft.ApplicationInsights.에 대한 모든 참조가 제거되었는지 확인합니다.

8. 애플리케이션 테스트

   애플리케이션에 예기치 않은 결과가 없는지 확인합니다.

1. NuGet 패키지 제거

   csproj 및 packages.config에서 Microsoft.ApplicationInsights.* 패키지를 제거합니다.

   dotnet remove package Microsoft.ApplicationInsights
   

   팁

   Microsoft.ApplicationInsights.WorkerService를 사용한 경우 WorkerService 탭을 참조하세요.

2. 초기화 코드 및 사용자 지정 제거

   코드베이스에서 Application Insights 형식에 대한 참조를 제거합니다.

   팁

   Application Insights 패키지를 제거한 후 애플리케이션을 다시 빌드하여 제거해야 하는 참조 목록을 가져올 수 있습니다.

   • TelemetryConfiguration 또는 TelemetryClient에 대한 참조를 제거합니다. Application Insights SDK를 초기화하는 것은 애플리케이션 시작의 일부여야 합니다.

     var config = TelemetryConfiguration.CreateDefault();
     var client = new TelemetryClient(config);
     

   팁

   AddApplicationInsightsTelemetryWorkerService()를 사용하여 Application Insights를 ServiceCollection에 추가한 경우 WorkerService 탭을 참조하세요.

3. 정리 및 빌드

   bin 디렉터리를 검사하여 Microsoft.ApplicationInsights.에 대한 모든 참조가 제거되었는지 확인합니다.

4. 애플리케이션 테스트

   애플리케이션에 예기치 않은 결과가 없는지 확인합니다.

1. NuGet 패키지 제거

   csproj에서 Microsoft.ApplicationInsights.WorkerService 패키지를 제거합니다.

   dotnet remove package Microsoft.ApplicationInsights.AspNetCore
   

2. 초기화 코드 및 사용자 지정 제거

   코드베이스에서 Application Insights 형식에 대한 참조를 제거합니다.

   팁

   Application Insights 패키지를 제거한 후 애플리케이션을 다시 빌드하여 제거해야 하는 참조 목록을 가져올 수 있습니다.

   • 다음 줄을 삭제하여 ServiceCollection에서 Application Insights를 제거합니다.

     builder.Services.AddApplicationInsightsTelemetryWorkerService();
     

   • appsettings.json에서 ApplicationInsights 섹션을 제거합니다.

     {
         "ApplicationInsights": {
             "ConnectionString": "<Your Connection String>"
         }
     }
     

3. 정리 및 빌드

   bin 디렉터리를 검사하여 Microsoft.ApplicationInsights.*에 대한 모든 참조가 제거되었는지 확인합니다.

4. 애플리케이션 테스트

   애플리케이션에 예기치 않은 결과가 없는지 확인합니다.

1. Azure Monitor Distro 설치

   Azure Monitor Distro는 추적, 메트릭, 로그, 예외를 수집하기 위한 OpenTelemetry 계측 라이브러리를 포함하여 자동 원격 분석을 활성화하고 사용자 지정 원격 분석을 수집할 수 있습니다.

   Azure Monitor Distro 설치는 OpenTelemetry SDK를 종속성으로 지정됩니다.

   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
   

2. OpenTelemetry 및 Azure Monitor 추가 및 구성

   OpenTelemery SDK는 애플리케이션 시작 시 ServiceCollection의 일부로, 일반적으로 Program.cs에서 구성되어야 합니다.

   OpenTelemetry에는 추적, 메트릭, 로그라는 세 가지 신호의 개념이 있습니다. Azure Monitor Distro는 이러한 각 신호를 구성합니다.

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 연결 문자열 구성에서 자세히 설명합니다.

1. Azure Monitor를 통해 OpenTelemetry SDK 설치

   Azure Monitor Exporter를 설치하면 OpenTelemetry SDK가 종속성으로 지정됩니다.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

2. 애플리케이션 시작의 일부로 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();
    }
}

1. Azure Monitor를 통해 OpenTelemetry SDK 설치

   Azure Monitor Exporter를 설치하면 OpenTelemetry SDK가 종속성으로 지정됩니다.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

2. 애플리케이션 시작의 일부로 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();
    }
}

1. Azure Monitor를 통해 OpenTelemetry SDK 설치

   Azure Monitor Exporter를 설치하면 OpenTelemetry SDK가 종속성으로 지정됩니다.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

   OpenTelemetry 확장 호스팅 패키지도 설치해야 합니다.

   dotnet add package OpenTelemetry.Extensions.Hosting
   

2. 애플리케이션 시작의 일부로 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();
    }
}

계측 라이브러리를 프로젝트에 추가하여 특정 구성 요소 또는 종속성에 대한 원격 분석을 자동으로 수집할 수 있습니다.

다음 라이브러리는 Distro에 포함되어 있습니다.

• HTTP
• ASP.NET Core
• SQL

계측 라이브러리 사용자 지정

Azure Monitor Distro에는 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 계측을 공급합니다. 안정적인 릴리스에 도달하면 표준 패키지 참조로 포함합니다. 그때까지 SQLClient 계측을 사용자 지정하려면 프로젝트에 OpenTelemetry.Instrumentation.SqlClient 패키지 참조를 추가하고 퍼블릭 API를 사용합니다.

dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient

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

계측 라이브러리를 프로젝트에 추가하여 특정 구성 요소 또는 종속성에 대한 원격 분석을 자동으로 수집할 수 있습니다. 다음 라이브러리를 사용하는 것이 좋습니다.

1. 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 추가 정보에서 전체 시작 가이드를 사용할 수 있습니다.

2. OpenTelemetry.Instrumentation.Http를 사용하여 아웃바운드 http 종속성에 대한 원격 분석을 수집할 수 있습니다. Azure Monitor는 이를 종속성 원격 분석에 매핑합니다.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   OpenTelemetry.Instrumentation.Http 추가 정보에서 전체 시작 가이드를 사용할 수 있습니다.

3. 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();
    }
}

계측 라이브러리를 프로젝트에 추가하여 특정 구성 요소 또는 종속성에 대한 원격 분석을 자동으로 수집할 수 있습니다. 다음 라이브러리를 사용하는 것이 좋습니다.

1. OpenTelemetry.Instrumentation.Http를 사용하여 아웃바운드 http 종속성에 대한 원격 분석을 수집할 수 있습니다. Azure Monitor는 이를 종속성 원격 분석에 매핑합니다.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   OpenTelemetry.Instrumentation.Http 추가 정보에서 전체 시작 가이드를 사용할 수 있습니다.

2. 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();
    }
}

계측 라이브러리를 프로젝트에 추가하여 특정 구성 요소 또는 종속성에 대한 원격 분석을 자동으로 수집할 수 있습니다. 다음 라이브러리를 사용하는 것이 좋습니다.

1. OpenTelemetry.Instrumentation.Http를 사용하여 아웃바운드 http 종속성에 대한 원격 분석을 수집할 수 있습니다. Azure Monitor는 이를 종속성 원격 분석에 매핑합니다.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   OpenTelemetry.Instrumentation.Http 추가 정보에서 전체 시작 가이드를 사용할 수 있습니다.

2. 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();
    }
}

Application Insights는 ApplicationInsightsServiceOptions를 통해 더 많은 구성 옵션을 제공했습니다.

사용자 지정 구성 제거

다음 시나리오는 선택 사항이며 고급 사용자에게만 적용됩니다.

• 원격 분석을 수동으로 기록하는 데 사용할 수 있는 TelemetryClient에 대한 참조가 더 있는 경우 제거해야 합니다.

• 사용자 지정 필터링 또는 보강을 사용자 지정TelemetryProcessor 또는 TelemetryInitializer 형식으로 추가한 경우 제거해야 합니다. 이는 ServiceCollection에서 찾을 수 있습니다.

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

  builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();
  

• JavaScript 코드 조각 제거

  Application Insights .NET SDK에서 제공하는 코드 조각을 사용한 경우 이를 제거해야 합니다. 제거할 항목에 대한 전체 코드 샘플은 웹 애플리케이션에 대한 클라이언트 쪽 원격 분석 사용 가이드를 검토하세요.

  클라이언트 쪽 원격 분석을 수집하기 위해 JavaScript SDK를 추가한 경우 이는 .NET SDK 없이 계속 작동하지만 제거할 수도 있습니다. 제거할 항목에 대한 전체 코드 샘플은 JavaScript SDK에 대한 온보딩 가이드를 검토하세요.

• Visual Studio Artifacts 제거

  Visual Studio를 사용하여 Application Insights에 온보딩한 경우 프로젝트에 남은 파일이 더 많을 수 있습니다.

  • Properties/ServiceDependencies 디렉터리에 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

Application Insights에 원격 분석을 보내려면 Azure Monitor Exporter를 세 가지 신호의 구성에 추가해야 합니다.

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 연결 문자열 구성에서 자세히 설명합니다.

Application Insights에 원격 분석을 보내려면 Azure Monitor Exporter를 세 가지 신호의 구성에 추가해야 합니다.

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에 대한 참조가 더 있는 경우 제거해야 합니다.

• 사용자 지정 TelemetryProcessor 또는 TelemetryInitializer로 추가된 사용자 지정 필터링 또는 보강을 제거합니다. 구성에서 이를 참조합니다.

• Visual Studio Artifacts 제거

  Visual Studio를 사용하여 Application Insights에 온보딩한 경우 프로젝트에 남은 파일이 더 많을 수 있습니다.

  • ConnectedService.json에는 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

  • [Your project's name].csproj에는 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

    <ApplicationInsightsResourceId>/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/Default-ApplicationInsights-EastUS/providers/microsoft.insights/components/WebApplication4</ApplicationInsightsResourceId>
    

Application Insights에 원격 분석을 보내려면 Azure Monitor Exporter를 세 가지 신호의 구성에 추가해야 합니다.

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 연결 문자열 구성에서 자세히 설명합니다.

추가 구성

Application Insights는 ApplicationInsightsServiceOptions를 통해 더 많은 구성 옵션을 제공했습니다.

사용자 지정 구성 제거

다음 시나리오는 선택 사항이며 고급 사용자에게 적용됩니다.

• 원격 분석을 수동으로 기록하는 데 사용되는 TelemetryClient에 대한 참조가 더 있는 경우 제거해야 합니다.

• 사용자 지정 필터링 또는 보강을 사용자 지정TelemetryProcessor 또는 TelemetryInitializer 형식으로 추가한 경우 이를 제거해야 합니다. ServiceCollection에서 참조를 찾을 수 있습니다.

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

  builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();
  

• Visual Studio Artifacts 제거

  Visual Studio를 사용하여 Application Insights에 온보딩한 경우 프로젝트에 남은 파일이 더 많을 수 있습니다.

  • Properties/ServiceDependencies 디렉터리에 Application Insights 리소스에 대한 참조가 있을 수 있습니다.

• Azure Monitor Distro 데모 프로젝트
• OpenTelemetry SDK의 시작 가이드
• OpenTelemetry의 예제 ASP.NET Core 프로젝트
• C# 및 .NET 로깅
• ASP.NET Core로 시작하는 Azure Monitor OpenTelemetry

• OpenTelemetry SDK의 시작 가이드
• OpenTelemetry의 예제 ASP.NET 프로젝트
• C# 및 .NET 로깅
• .NET으로 시작하는 Azure Monitor OpenTelemetry

• OpenTelemetry SDK의 시작 가이드
• OpenTelemetry의 예제 프로젝트:
  • 추적 시작
  • 메트릭 시작
  • 로그 시작
• C# 및 .NET 로깅
• .NET으로 시작하는 Azure Monitor OpenTelemetry

• OpenTelemetry SDK의 시작 가이드
• C# 및 .NET에서 로깅
• .NET으로 시작하는 Azure Monitor OpenTelemetry

• Azure 지원 문제의 경우 Azure 지원 티켓을 엽니다.
• OpenTelemetry 문제의 경우 OpenTelemetry .NET 커뮤니티에 직접 문의합니다.
• Azure Monitor Exporter와 관련된 미해결 문제 목록은 GitHub 문제 페이지를 참조하세요.

• Azure 지원 문제의 경우 Azure 지원 티켓을 엽니다.
• OpenTelemetry 문제의 경우 OpenTelemetry .NET 커뮤니티에 직접 문의합니다.
• Azure Monitor Exporter와 관련된 미해결 문제 목록은 GitHub 문제 페이지를 참조하세요.

• Azure 지원 문제의 경우 Azure 지원 티켓을 엽니다.
• OpenTelemetry 문제의 경우 OpenTelemetry .NET 커뮤니티에 직접 문의합니다.
• Azure Monitor Exporter와 관련된 미해결 문제 목록은 GitHub 문제 페이지를 참조하세요.

• Azure 지원 문제의 경우 Azure 지원 티켓을 엽니다.
• OpenTelemetry 문제의 경우 OpenTelemetry .NET 커뮤니티에 직접 문의합니다.
• Azure Monitor Exporter와 관련된 미해결 문제 목록은 GitHub 문제 페이지를 참조하세요.