Переход с пакетов SDK Application Insights на Azure Monitor OpenTelemetry

Если вы начинаете работу с Application Insights и не хотите переноситься из классического API, см. статью "Включить Azure Monitor OpenTelemetry".

Предпосылки

ASP.NET Core

• Веб-приложение ASP.NET Core уже инструментировано с помощью Application Insights без каких-либо настроек.
• Активно поддерживаемая версия .NET.

ASP.NET

• Веб-приложение ASP.NET уже инструментировано с помощью Application Insights.
• Активно поддерживаемая версия .NET Framework.

Console

• Консольное приложение уже инструментировано с помощью Application Insights.
• Активно поддерживаемая версия .NET Framework или .NET.

WorkerService

• Приложение WorkerService уже инструментировано с помощью Application Insights без каких-либо настроек.
• Активно поддерживаемая версия .NET.

Удаление пакета SDK Application Insights

ASP.NET Core

1. Удаление пакетов NuGet

   Microsoft.ApplicationInsights.AspNetCore Удалите пакет из вашего csprojприложения.

   dotnet remove package Microsoft.ApplicationInsights.AspNetCore
   

2. Удалите код инициализации и кастомизации

   Удалите все ссылки на типы Application Insights в базе кода.

   Подсказка

   После удаления пакета Application Insights вы можете повторно создать приложение, чтобы получить список ссылок, которые необходимо удалить.

   • Удалите Application Insights из вашей ServiceCollection строки, удалив следующую строку:

     builder.Services.AddApplicationInsightsTelemetry();
     

   • Удалите раздел ApplicationInsights из вашего appsettings.json.

     {
         "ApplicationInsights": {
             "ConnectionString": "<YOUR-CONNECTION-STRING>"
         }
     }
     

3. Очистка и сборка

   Проверьте каталог bin, чтобы убедиться, что все ссылки на Microsoft.ApplicationInsights.* были удалены.

4. Тестирование приложения

   Убедитесь, что приложение не имеет непредвиденных последствий.

ASP.NET

1. Удаление пакетов NuGet

   Удалите Microsoft.AspNet.TelemetryCorrelation пакет и все Microsoft.ApplicationInsights.* пакеты из вашего csproj и packages.config.

2. Удалите файл ApplicationInsights.config.

3. Удалите раздел из файла приложения Web.config .

   • Два httpModules автоматически добавлены в web.config при первом добавлении ApplicationInsights в проект.

     Любые ссылки на TelemetryCorrelationHttpModule и ApplicationInsightsWebTracking должны быть удалены. Если вы добавили Application Insights в модули 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.

4. Удаление кода инициализации и настроек

   Удалите все ссылки на типы Application Insights в базе кода.

   Подсказка

   После удаления пакета Application Insights вы можете повторно создать приложение, чтобы получить список ссылок, которые необходимо удалить.

   • Удаление ссылок на TelemetryConfiguration или TelemetryClient. Это часть запуска приложения для инициализации пакета SDK Application Insights.

   • Следующие сценарии являются необязательными и предназначены для опытных пользователей.

     • Если у вас есть ссылки на TelemetryClient, которые используются для вручную записывать телеметрию, их следует удалить.
     • Если вы добавили любую пользовательскую фильтрацию или обогащение в виде пользовательского TelemetryProcessor или TelemetryInitializer, их следует удалить. Вы можете найти их упомянутыми в вашей конфигурации.
     • Если в вашем проекте в каталоге App_Start есть FilterConfig.cs, проверьте наличие пользовательских обработчиков исключений, ссылающихся на Application Insights, и удалите их.

5. Удаление фрагмента кода JavaScript

   Если вы добавили пакет SDK JavaScript для сбора данных телеметрии на стороне клиента, его также можно удалить, хотя он продолжает работать без пакета SDK для .NET. Полные примеры кода для удаления см. в руководстве по подключению пакета SDK для JavaScript.

6. Удалите любые артефакты 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-EastUS/providers/microsoft.insights/components/WebApplication4</ApplicationInsightsResourceId>
     

7. Очистка и сборка

   Проверьте каталог bin, чтобы убедиться, что все ссылки на Microsoft.ApplicationInsights. были удалены.

8. Тестирование приложения

   Убедитесь, что приложение не имеет непредвиденных последствий.

Console

1. Удаление пакетов NuGet

   Удалите все Microsoft.ApplicationInsights.* пакеты из ваших csproj и packages.config.

   dotnet remove package Microsoft.ApplicationInsights
   

   Подсказка

   Если вы использовали Microsoft.ApplicationInsights.WorkerService, перейдите на вкладки WorkerService.

2. Удалите код и кастомизации инициализации

   Удалите все ссылки на типы Application Insights в базе кода.

   Подсказка

   После удаления пакета Application Insights вы можете повторно создать приложение, чтобы получить список ссылок, которые необходимо удалить.

   • Удаление ссылок на TelemetryConfiguration или TelemetryClient. Оно должно быть частью запуска приложения, чтобы инициализировать пакет SDK Application Insights.

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

   Подсказка

   Если вы использовали AddApplicationInsightsTelemetryWorkerService() для добавления Application Insights в ServiceCollection, обратитесь к вкладкам WorkerService.

3. Очистка и сборка

   Проверьте каталог bin, чтобы убедиться, что все ссылки на Microsoft.ApplicationInsights. были удалены.

4. Тестирование приложения

   Убедитесь, что приложение не имеет непредвиденных последствий.

WorkerService

1. Удаление пакетов NuGet

   Удалите Microsoft.ApplicationInsights.WorkerService пакет из вашего csproj.

   dotnet remove package Microsoft.ApplicationInsights.WorkerService
   

2. Удалите код и настройки инициализации

   Удалите все ссылки на типы Application Insights в базе кода.

   Подсказка

   После удаления пакета Application Insights вы можете повторно создать приложение, чтобы получить список ссылок, которые необходимо удалить.

   • Удалите Application Insights из вашей ServiceCollection строки, удалив следующую строку:

     builder.Services.AddApplicationInsightsTelemetryWorkerService();
     

   • Удалите секцию ApplicationInsights из вашего appsettings.json.

     {
         "ApplicationInsights": {
             "ConnectionString": "<YOUR-CONNECTION-STRING>"
         }
     }
     

3. Очистка и сборка

   Проверьте каталог bin, чтобы убедиться, что все ссылки на Microsoft.ApplicationInsights.* были удалены.

4. Тестирование приложения

   Убедитесь, что приложение не имеет непредвиденных последствий.

Включение OpenTelemetry

Мы рекомендуем создать ресурс разработки и использовать его строку подключения при выполнении этих инструкций.

Запланируйте обновление строки подключения для отправки телеметрии исходному ресурсу после подтверждения успешной миграции.

ASP.NET Core

1. Установка дистрибутива Azure Monitor

   Наш дистрибутив Azure Monitor обеспечивает автоматическую телеметрию, включая библиотеки инструментирования OpenTelemetry для сбора трассировок, метрик, журналов и исключений, а также позволяет собирать пользовательские данные телеметрии.

   Установка дистрибутива Azure Monitor включает пакет SDK OpenTelemetry в качестве зависимости.

   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
   

2. Добавление и настройка OpenTelemetry и Azure Monitor

   SDK OpenTelemetry должен быть настроен при запуске приложения в качестве части вашей 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

1. Установка пакета SDK OpenTelemetry с помощью Azure Monitor

   Установка экспортера Azure Monitor предоставляет пакет SDK OpenTelemetry в качестве зависимости.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

2. Настройка OpenTelemetry в рамках запуска приложения

   Пакет SDK OpenTelemetry должен быть настроен при запуске приложения, как правило, в 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

1. Установка пакета SDK OpenTelemetry с помощью Azure Monitor

   Установка экспортера Azure Monitor включает пакет SDK OpenTelemetry как зависимость.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

2. Настройка OpenTelemetry в рамках запуска приложения

   Пакет SDK OpenTelemery должен быть настроен при запуске приложения, как правило, в .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

1. Установка пакета SDK OpenTelemetry с помощью Azure Monitor

   Установка экспортера Azure Monitor добавляет SDK OpenTelemetry в качестве зависимости.

   dotnet add package Azure.Monitor.OpenTelemetry.Exporter
   

   Также необходимо установить пакет OpenTelemetry Extensions Hosting.

   dotnet add package OpenTelemetry.Extensions.Hosting
   

2. Настройка OpenTelemetry в рамках запуска приложения

   SDK OpenTelemetry должен быть настроен при запуске приложения, как правило, в 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();
    }
}

Установка и настройка библиотек инструментирования

ASP.NET Core

Библиотеки инструментирования можно добавить в проект для автоматического сбора данных телеметрии о конкретных компонентах или зависимостях.

В дистрибутив включены следующие библиотеки.

• HTTP
• ASP.NET Core
• SQL

Настройка библиотек инструментирования

Дистрибутив Azure Monitor включает инструментирование .NET OpenTelemetry для ASP.NET Core, HttpClient и SQLClient. Эти встроенные инструменты можно настроить или вручную добавить дополнительные инструментальные средства с помощью API OpenTelemetry.

Ниже приведены некоторые примеры настройки инструментирования.

Настройка 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;
    });
});

ASP.NET

Библиотеки инструментирования можно добавить в проект для автоматического сбора данных телеметрии о конкретных компонентах или зависимостях. Рекомендуется использовать следующие библиотеки:

1. OpenTelemetry.Instrumentation.AspNet можно использовать для сбора данных телеметрии для входящих запросов. Azure Monitor сопоставляет его с Request Telemetry.

   dotnet add package OpenTelemetry.Instrumentation.AspNet
   

   Чтобы это сделать, требуется добавить дополнительный HttpModule в ваш Web.config.

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

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.AspNet Readme

2. OpenTelemetry.Instrumentation.Http можно использовать для сбора данных телеметрии для исходящих зависимостей HTTP. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.Http Readme

3. OpenTelemetry.Instrumentation.SqlClient можно использовать для сбора данных телеметрии для зависимостей MS SQL. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.SqlClient Readme

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

Библиотеки инструментирования можно добавить в проект для автоматического сбора данных телеметрии о конкретных компонентах или зависимостях. Рекомендуется использовать следующие библиотеки:

1. OpenTelemetry.Instrumentation.Http можно использовать для сбора данных телеметрии для исходящих зависимостей HTTP. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.Http Readme

2. OpenTelemetry.Instrumentation.SqlClient можно использовать для сбора данных телеметрии для зависимостей MS SQL. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.SqlClient Readme

Следующий пример кода развивает предыдущий пример. Теперь она собирает данные телеметрии, но пока не отправляется в 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

Библиотеки инструментирования можно добавить в проект для автоматического сбора данных телеметрии о конкретных компонентах или зависимостях. Рекомендуется использовать следующие библиотеки:

1. OpenTelemetry.Instrumentation.Http можно использовать для сбора данных телеметрии для исходящих зависимостей HTTP. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package OpenTelemetry.Instrumentation.Http
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.Http Readme

2. OpenTelemetry.Instrumentation.SqlClient можно использовать для сбора данных телеметрии для зависимостей MS SQL. Azure Monitor сопоставляет его с телеметрией зависимостей.

   dotnet add package --prerelease OpenTelemetry.Instrumentation.SqlClient
   

   Полное руководство по началу работы доступно здесь: OpenTelemetry.Instrumentation.SqlClient Readme

Следующий пример кода расширяет предыдущий пример. Теперь она собирает данные телеметрии, но пока не отправляется в 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.

Удаление пользовательских конфигураций

Следующие сценарии являются необязательными и применяются только к расширенным пользователям.

• Если у вас есть какие-либо упоминания о TelemetryClient, которые можно использовать для ручной записи телеметрии, их следует удалить.

• Если вы добавили любую пользовательскую фильтрацию или обогащение в виде пользовательского TelemetryProcessor или TelemetryInitializer, их следует удалить. Их можно найти в вашем ServiceCollection.

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

  builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();
  

• Удаление фрагмента кода JavaScript

  Если вы использовали фрагмент кода, предоставленный пакетом SDK для .NET Application Insights, он также должен быть удален. Полные примеры кода для удаления см. в руководстве по включению телеметрии на стороне клиента для веб-приложений.

  Если вы добавили пакет SDK JavaScript для сбора данных телеметрии на стороне клиента, его также можно удалить, хотя он продолжает работать без пакета SDK для .NET. Полные примеры кода для удаления см. в руководстве по подключению пакета SDK для JavaScript.

• Удалите любые артефакты 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, который используется для ручной записи телеметрии, их следует удалить.

• Удалите любые пользовательские фильтры или добавления, добавленные в качестве пользовательского TelemetryProcessor или TelemetryInitializer. Конфигурация ссылается на них.

• Удалите любые артефакты 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-EastUS/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.

Дополнительные конфигурации

Application Insights предлагает множество дополнительных параметров конфигурации с помощью ApplicationInsightsServiceOptions.

Удаление пользовательских конфигураций

Следующие сценарии являются необязательными и применяются к опытным пользователям.

• Если у вас есть другие ссылки на TelemetryClient, которые используются для ручной записи телеметрии, их следует удалить.

• Если вы добавили любую пользовательскую фильтрацию или обогащение в виде настраиваемого TelemetryProcessor или TelemetryInitializer, то его следует удалить. Ссылки можно найти в вашем ServiceCollection.

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

  builder.Services.AddApplicationInsightsTelemetryProcessor<MyCustomTelemetryProcessor>();
  

• Удалите любые артефакты Visual Studio

  Если вы использовали Visual Studio для подключения к Application Insights, в проекте может быть больше файлов.

  • Properties/ServiceDependencies В каталоге может быть ссылка на ресурс Application Insights.

Дальнейшие шаги

• Чтобы ознакомиться с часто задаваемыми вопросами (FAQ), см. статью "Миграция пакетов SDK для .NET Application Insights в Azure Monitor OpenTelemetry"
• Руководство по началу работы с пакетом SDK для OpenTelemetry
• Пример проекта OpenTelemetry ASP.NET Core
• Логирование в C# и .NET
• Руководство по началу работы с Azure Monitor OpenTelemetry в ASP.NET Core

Примеры проектов

• ASP.NET Core: демонстрационный проект дистрибутива Azure Monitor
• ASP.NET: пример проекта ASP.NET OpenTelemetry
• Консоль:
  • Начало работы с трассировками
  • Начало работы с метриками
  • Начало работы с журналами

Support

• Для проблем с поддержкой Azure откройте запрос в службу поддержки Azure.
• Для проблем с OpenTelemetry обратитесь непосредственно к сообществу OpenTelemetry .NET .
• Список открытых проблем, связанных с экспортером Azure Monitor, см. на странице проблем GitHub.

При обновлении до 3.x изменения кода обычно не требуются. Зависимости пакета SDK 3.x — это версии API без выполнения операций зависимостей пакета SDK 2.x. Однако при использовании с агентом Java 3.x агент Java 3.x предоставляет для них реализацию. В результате настраиваемое инструментирование сопоставляется со всеми новыми автоматическими средствами, предоставляемыми агентом Java 3.x.

Шаг 1. Обновление зависимостей

Шаг 2. Добавление агента Java 3.x

Добавьте агент Java 3.x в параметры командной строки Java Virtual Machine (JVM), например:

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

Если вы используете агент Java Application Insights 2.x, просто замените существующий -javaagent:... на предыдущий пример.

Шаг 3. Настройка строки подключения Application Insights

См. настройку строки подключения.

Другие примечания

В остальной части этого документа описываются ограничения и изменения, которые могут возникнуть при обновлении с версии 2.x до 3.x, а также некоторые обходные пути, которые могут оказаться полезными.

Инициализаторы телеметрии

Инициализаторы телеметрии SDK 2.x не выполняются при использовании агента 3.x. Многие из сценариев использования, которые ранее требовали написания TelemetryInitializer, теперь можно реализовать в Application Insights Java 3.x, настроив настраиваемые размеры или используя унаследованные атрибуты.

TelemetryProcessors

2.x TelemetryProcessors не выполняются при использовании агента 3.x. Многие из случаев использования, для которых ранее требовалось писать TelemetryProcessor, теперь можно решить в Application Insights Java 3.x, настроив переопределения выборки.

Несколько приложений в одном JVM

Этот вариант использования поддерживается в Application Insights Java 3.x с помощью переопределения имен ролей облака (предварительная версия) и (или) переопределения строк подключения (предварительная версия).

Имена операций

В пакете SDK Для Java 2.x Application Insights в некоторых случаях имена операций содержат полный путь, например:

Имена операций в Application Insights Java 3.x изменились, чтобы обеспечить лучшее агрегированное представление на портале Application Insights U/X, например:

Однако для некоторых приложений можно по-прежнему предпочесть агрегированное представление в U/X, предоставленное предыдущими именами операций. В этом случае можно использовать функцию обработчиков телеметрии (предварительная версия) в 3.x для репликации предыдущего поведения.

Следующий фрагмент кода настраивает три процессора телеметрии, которые объединяются для репликации предыдущего поведения. Процессоры телеметрии выполняют следующие действия (в порядке):

1. Первый обработчик телеметрии — это обработчик атрибутов (имеет тип attribute), который означает, что он применяется ко всем данным телеметрии, которые имеют атрибуты (в настоящее время requests и dependencies, но в ближайшее время также traces).

   Он соответствует любой телеметрии, которая имеет атрибуты с именем http.request.method и url.path.

   Затем он извлекает url.path атрибут в новый атрибут с именем tempName.

2. Второй обработчик телеметрии — это процессор диапазона (имеет тип span), то есть он применяется к requests и dependencies.

   Он соответствует любому диапазону, у которого есть атрибут с именем tempPath.

   Затем он обновляет имя диапазона из атрибута tempPath.

3. Последний обработчик телеметрии — это обработчик атрибутов, тот же тип, что и первый обработчик телеметрии.

   Он соответствует любой телеметрии, у которой атрибут имеет имя 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, что может вызвать неожиданные пропуски в логах.

Пример проекта

Этот проект пакета SDK java 2.x переносится в новый проект с помощью агента Java 3.x.

В этом руководстве представлено два варианта обновления пакета SDK Node.js 2.X для Application Insights до OpenTelemetry.

• Чистая установка дистрибутива Node.js Azure Monitor OpenTelemetry.

  • Удалите зависимости от классического API Application Insights.
  • Ознакомьтесь с API и терминами OpenTelemetry.
  • Позиционируйте себя, чтобы использовать все, что OpenTelemetry предлагает сейчас и в будущем.

• Обновление до Node.js пакета SDK 3.X.

  • Откладывайте изменения кода при сохранении совместимости с существующими пользовательскими событиями и метриками.
  • Доступ к более богатым библиотекам инструментирования OpenTelemetry.
  • Сохраняйте право на наличие последних исправлений ошибок и безопасности.

Очистка установки

1. Получите необходимые знания о интерфейсе программирования приложений JavaScript OpenTelemetry (API) и пакете средств разработки программного обеспечения (SDK).

   • Ознакомьтесь с документацией по OpenTelemetry JavaScript.
   • Проверьте настройку Azure Monitor OpenTelemetry.
   • Оцените добавление, изменение и фильтрацию OpenTelemetry.

2. Удалите зависимость applicationinsights из вашего проекта.

   npm uninstall applicationinsights
   

3. Удалите реализацию ПАКЕТА SDK 2.X из кода.

   Удалите все средства мониторинга Application Insights из кода. Удалите все разделы, в которых клиент Application Insights инициализируется, изменяется или вызывается.

4. Включите Application Insights с помощью дистрибутива OpenTelemetry в Azure Monitor.

   Это важно

   Прежде чем импортировать что-либо другое, useAzureMonitor необходимо вызвать. Если сначала импортируются другие библиотеки, может возникнуть потеря телеметрии. Следуйте разделу начало работы для подключения к дистрибутиву OpenTelemetry для Azure Monitor.

Изменения и ограничения для дистрибутива OpenTelemetry на Azure Monitor

• API из пакета SDK 2.X Application Insights недоступны в дистрибутиве OpenTelemetry в Azure Monitor. Хотя пакет SDK для Application Insights 3.X предоставляет неразрывный путь обновления для приема телеметрии (например, пользовательские события и метрики), большинство API-интерфейсов SDK 2.X не поддерживаются и требуют изменения кода в API на основе OpenTelemetry.
• Фильтрация зависимостей, журналов и исключений по имени операции еще не поддерживается.

Upgrade

1. Обновите зависимость для пакета applicationinsights.

   npm update applicationinsights
   

2. Перестройте приложение.

3. Протестируйте приложение.

   Чтобы избежать использования неподдерживаемых параметров конфигурации в пакете SDK для Application Insights 3.X, см. раздел "Неподдерживаемые свойства".

   Если SDK регистрирует предупреждения о неподдерживаемом использовании API после значительного обновления версии, и вам необходима соответствующая функциональность, продолжайте использовать SDK Application Insights версии 2.X.

Изменения и ограничения

Следующие изменения и ограничения применяются к обоим путям обновления.

поддержка версий Node.js

Чтобы версия Node.js поддерживалась пакетом SDK ApplicationInsights 3.X, она должна иметь перекрывающуюся поддержку и пакета SDK Azure, и OpenTelemetry. Проверьте поддерживаемые среды выполнения OpenTelemetry для последних обновлений. Пользователи более ранних версий, таких как Node 8, ранее поддерживаемые пакетом SDK ApplicationInsights, по-прежнему могут использовать решения OpenTelemetry, но могут столкнуться с непредвиденным или критическим поведением. Пакет SDK ApplicationInsights также зависит от пакета SDK Azure для JS, который не гарантирует поддержку любых версий Node.js, которые достигли конца жизни. Ознакомьтесь с политикой поддержки Azure SDK для JS. Чтобы версия Node.js поддерживалась пакетом SDK ApplicationInsights 3.X, она должна иметь перекрывающуюся поддержку и пакета SDK Azure, и OpenTelemetry.

Параметры конфигурации

Пакет SDK Application Insights версии 2.X предлагает параметры конфигурации, которые недоступны в дистрибутиве OpenTelemetry Azure Monitor или в обновлении основной версии до пакета SDK Application Insights 3.X. Чтобы найти эти изменения, а также параметры, которые мы по-прежнему поддерживаем, см . документацию по настройке пакета SDK.

Расширенные метрики

Расширенные метрики поддерживаются в пакете SDK для Application Insights 2.X; Однако поддержка этих метрик заканчивается в обоих версиях 3.X пакета SDK ApplicationInsights и дистрибутиве OpenTelemetry в Azure Monitor.

Обработчики данных телеметрии

Хотя Azure Monitor OpenTelemetry Distro и SDK Application Insights 3.X не поддерживают TelemetryProcessors, они позволяют передавать процессоры span и log record. Дополнительные сведения о том, как это сделать, см. в проекте 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;
}

В этом примере показано, как изменить реализацию дистрибутива OpenTelemetry в Azure Monitor, чтобы передать SpanProcessor в конфигурацию дистрибутива.

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);

Выполните следующие действия, чтобы перенести приложения Python в Azure Monitor OpenTelemetry дистрибутив.

Шаг 1. Удаление библиотек OpenCensus

Удалите все библиотеки, связанные с OpenCensus, включая все пакеты Pypi, начинающиеся с opencensus-*.

pip freeze | grep opencensus | xargs pip uninstall -y

Шаг 2. Удаление OpenCensus из кода

Удалите все экземпляры пакета SDK OpenCensus и экспортера OpenCensus для Azure Monitor из кода.

Проверьте инструкции импорта, начинающиеся с opencensus, чтобы найти все интеграции, экспортеры и экземпляры API или пакета SDK OpenCensus, которые должны быть удалены.

Приведены следующие примеры инструкций импорта, которые необходимо удалить.

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. Знакомство с API-интерфейсами и пакетами SDK для OpenTelemetry Python

В следующей документации содержатся необходимые знания об API и SDK для OpenTelemetry Python.

• Документация по OpenTelemetry для Python
• Документация по дистрибутиву Azure Monitor по конфигурации и телеметрии

Шаг 4. Настройка дистрибутива OpenTelemetry в Azure Monitor

Следуйте инструкциям на странице начала работы , чтобы подключиться к дистрибутиву OpenTelemetry в Azure Monitor.

Изменения и ограничения

При переходе с OpenCensus на OpenTelemetry могут возникнуть следующие изменения и ограничения.

Поддержка Python < 3.7

Решения мониторинга на основе Python в OpenTelemetry поддерживают только Python 3.7 и больше, за исключением ранее поддерживаемых версий Python 2.7, 3.4, 3.5 и 3.6 из OpenCensus. Мы рекомендуем обновить пользователей, которые находятся на более старых версиях Python, так как по мере написания этого документа эти версии уже достигли конца жизни. Пользователи, которые твердо решили не обновляться, все еще могут продолжать использовать решения OpenTelemetry, но могут столкнуться с неожиданным или кризисным поведением, которое не поддерживается. В любом случае последняя поддерживаемая версия opencensus-ext-azure всегда существует и по-прежнему работает для этих версий, но новые выпуски не создаются для этого проекта.

Configurations

OpenCensus Python предоставил некоторые параметры конфигурации , связанные с коллекцией и экспортом телеметрии. Вы достигаете те же конфигурации и даже больше, используя API и SDK OpenTelemetry Python. Дистрибутив Python для OpenTelemetry в Azure Monitor представляет собой универсальное решение для самых распространенных потребностей в мониторинге ваших приложений на Python. Так как дистрибутив инкапсулирует API OpenTelemetry/SDk, некоторые конфигурации для более редких вариантов использования в настоящее время не поддерживаются для дистрибутива. Вместо этого вы можете подключиться к экспортеру Azure Monitor OpenTelemetry, который с API и SDK OpenTelemetry должен соответствовать вашим потребностям в мониторинге. Некоторые из этих конфигураций включают:

• Пользовательские распространители
• Пользовательские сэмплеры
• Добавление дополнительных процессоров для обработки интервалов, журналов и модулей чтения метрик.

Связь с функциями Azure

Чтобы предоставить возможности распределенной трассировки для приложений Python, которые вызывают другие приложения Python в функции Azure, пакет opencensus-extension-azure-functions был предоставлен, чтобы разрешить подключенный распределенный граф.

В настоящее время решения OpenTelemetry для Azure Monitor не поддерживают этот сценарий. В качестве обходного решения можно вручную распространить контекст трассировки в приложении функций Azure, как показано в следующем примере.

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)

Расширения и экспортёры

Пакет SDK OpenCensus предлагает способы сбора и экспорта данных телеметрии с помощью интеграции OpenCensus и экспортеров соответственно. В OpenTelemetry интеграция теперь называется инструментированием, в то время как экспортеры остались с той же терминологией. Инструментирование и экспортеры OpenTelemetry Python являются супермножеством того, что было предоставлено в OpenCensus, поэтому с точки зрения охвата библиотек и их функциональности библиотеки OpenTelemetry представляют собой прямое улучшение. Что касается дистрибутива Azure Monitor OpenTelemetry, он содержит некоторые из популярных инструментов OpenTelemetry для Python по умолчанию, поэтому дополнительный код не требуется. Майкрософт полностью поддерживает эти инструменты.

Что касается других инструментов OpenTelemetry Python, которые не включены в список, пользователи по-прежнему могут вручную добавлять их. Однако важно отметить, что стабильность и поведение не гарантированы или поддерживаются в этих случаях. Поэтому используйте их по своему усмотрению.

Если вы хотите предложить библиотеку инструментирования сообщества для включения в наш дистрибутив, опубликуйте или поддержите идею в нашем сообществе отзывов. Для экспортеров дистрибутив Azure Monitor OpenTelemetry поставляется вместе с экспортером Azure Monitor OpenTelemetry . Если вы также хотите использовать других экспортеров, их можно использовать с дистрибутивом, как показано в этом примере.

TelemetryProcessors

В мире OpenTelemetry нет концепции TelemetryProcessors, но существуют API и классы, которые можно использовать для воспроизведения такого же поведения.

Настройка имени облачной роли и экземпляра облачной роли

Следуйте инструкциям здесь, чтобы задать имя облачной роли и экземпляр этой роли для вашей телеметрии. Дистрибутив Azure Monitor OpenTelemetry автоматически извлекает значения из переменных среды и заполняет соответствующие поля.

Изменение диапазонов с помощью SpanProcessors

Скоро.

Изменение метрик с помощью представлений

Скоро.

Счетчики производительности

Экспортер OpenCensus Azure Monitor автоматически собирает системные метрики и метрики производительности, называемые счетчиками производительности. Эти метрики отображаются в performanceCounters экземпляре Application Insights. В OpenTelemetry мы больше не отправляем эти метрики напрямую performanceCounters. Метрики, связанные с входящими и исходящими запросами, можно найти в стандартных метриках. Если вы хотите, чтобы OpenTelemetry использовала системные метрики, связанные с системой, можно использовать инструментирование экспериментальных системных метрик, внесенных сообществом Python OpenTelemetry. Этот пакет является экспериментальным и официально не поддерживается корпорацией Майкрософт.

Support

Для просмотра шагов по устранению неполадок, вариантов поддержки или обратной связи по OpenTelemetry см. в статье "Устранение неполадок, поддержка и обратная связь для Azure Monitor Application Insights".