Включение Azure Monitor OpenTelemetry для приложений .NET, Node.js, Python и Java

В этой статье описывается, как включить и настроить сбор данных на основе OpenTelemetry в Azure Monitor Application Insights. Дистрибутив OpenTelemetry для Azure Monitor:

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

Для получения дополнительной информации о преимуществах использования дистрибутива OpenTelemetry для Azure Monitor см. раздел Почему следует использовать дистрибутив OpenTelemetry для Azure Monitor.

Дополнительные сведения о сборе данных с помощью OpenTelemetry можно найти в статье "Сбор OpenTelemetry (OTel) для платформы Application Insights" или в часто задаваемых вопросах по OpenTelemetry.

Состояние выпуска OpenTelemetry

Предложения OpenTelemetry доступны для приложений .NET, Node.js, Python и Java. Для получения сведений о состоянии выпуска каждой функции см. часто задаваемые вопросы.

Примечание.

Для приложений Azure Functions см. раздел Использование OpenTelemetry с Azure Functions.

Активировать OpenTelemetry с помощью Application Insights

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

Примечание.

.NET охватывает несколько сценариев, включая классические ASP.NET, консольные приложения, Windows Forms (WinForms) и многое другое.

Предварительные условия

подписка Azure: Создайте бесплатную подписку Azure
Ресурс Application Insights. Создание ресурса Application Insights.

Приложение ASP.NET Core с официально поддерживаемой версией .NET

Совет

Если вы переходите с классического API Application Insights, ознакомьтесь с нашей документацией по миграции.

Установка клиентской библиотеки

Установите последний пакет Azure.Monitor.OpenTelemetry.AspNetCoreNuGet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Установите последний пакет Azure.Monitor.OpenTelemetry.ExporterNuGet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Установите последний @azure/monitor-opentelemetry пакет:

npm install @azure/monitor-opentelemetry

Следующие пакеты также используются для некоторых конкретных сценариев, описанных далее в этой статье:

@opentelemetry/api
`@opentelemetry/sdk-metrics`
@opentelemetry/ресурсы
@opentelemetry/semantic-conventions (семантические соглашения)
@opentelemetry/sdk-trace-base

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Установите последний пакет PyPI для azure-monitor-opentelemetry :

pip install azure-monitor-opentelemetry

Изменение приложения

Импортируйте пространство имен Azure.Monitor.OpenTelemetry.AspNetCore, добавьте OpenTelemetry и настройте его для использования Azure Monitor в классе program.cs:

// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

var app = builder.Build();

app.Run();

Добавьте экспортёр Azure Monitor к каждому сигналу OpenTelemetry в классе program.cs.

// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

Примечание.

Дополнительные сведения см. в руководстве для начинающих по OpenTelemetry .NET

Автоинструментация включена с помощью изменений конфигурации. Никаких изменений кода не требуется.

Укажите Java виртуальной машине (JVM) путь к JAR-файлу, добавив -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" в аргументы JVM вашего приложения.

Примечание.

Выборка включена по умолчанию в размере пяти запросов в секунду, помогая в управлении затратами. Данные телеметрии могут быть отсутствуют в сценариях, превышающих эту скорость. Для получения дополнительной информации об изменении конфигурации выборки см. переопределение параметров выборки. Если вы видите непредвиденные расходы или высокие затраты в Application Insights, это руководство может помочь. В ней рассматриваются распространенные причины, такие как высокий объем телеметрии, пики приема данных и неправильно настроенная выборка. Особенно полезно, если вы устраняете проблемы, связанные с резким увеличением затрат, объемом телеметрии, неисправной выборкой, ограничениями данных, высокой нагрузкой на прием данных или неожиданными счетами. Чтобы начать, ознакомьтесь с материалом по устранению неполадок в случае высокого объёма поступающих данных в Application Insights.

Совет

Инструкции по сценарию см. в разделе "Начало работы" (дополнительное приложение).

Совет

При разработке приложения Spring Boot можно при необходимости заменить аргумент JVM программными конфигурациями. Дополнительные сведения см. в разделе Использование Azure Monitor Application Insights вместе с Spring Boot.

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

import logging
# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

Скопируйте строку подключения (connection string) из ресурса Application Insights

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

Совет

Если у вас еще нет ресурса Application Insights, следуйте этому руководству чтобы создать его. Рекомендуется создать новый ресурс, а не использовать существующий.

Чтобы скопировать connection string, выполните следующие действия.

Перейдите в панель Overview ресурса Application Insights.
Найдите строку подключения.
Подведите указатель мыши к connection string и выберите значок Копировать в буфер обмена.

Вставьте строку подключения в вашу среду

Чтобы вставить connection string, выберите из следующих параметров:

Внимание

Рекомендуется задать connection string с помощью кода только в локальных средах разработки и тестирования.

В рабочей среде используйте переменную среды или файл конфигурации (только Java).

Установлено через переменную окружения - рекомендуется

Замените <Your connection string> в следующей команде на вашу строку подключения.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Установлено с помощью файла конфигурации - Только для Java

Создайте файл конфигурации с именем applicationinsights.jsonи поместите его в тот же каталог, что applicationinsights-agent-3.7.5.jar и в следующем содержимом:
```
{
  "connectionString": "<Your connection string>"
}
```
Замените <Your connection string> в предыдущем JSON на вашу уникальную строку подключения.
Задано через код - только ASP.NET Core, Node.js и Python

Пример настройки connection string с помощью кода см. в разделе конфигурация connection string.

Примечание.

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

Код
Переменная среды
Файл конфигурации

Подтвердите, что данные поступают

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

Снимок экрана вкладки

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

Примечание.

В рамках использования инструментирования Application Insights мы собираем диагностические данные и отправляем их в корпорацию Майкрософт. Эти данные помогают нам использовать и улучшать Application Insights. Дополнительные сведения см. в разделе "Вопросы и ответы о Application Insights".

Внимание

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

Устранение неполадок, обратная связь и поддержка

Совет

Во всех статьях о дистрибутивах OpenTelemetry доступны следующие разделы.

Troubleshooting

Сведения об устранении неполадок см. в статье "Устранение неполадок с OpenTelemetry" в .NET и устранение неполадок с отсутствующими данными телеметрии приложений в Azure Monitor Application Insights.

Отзывы о OpenTelemetry

Чтобы оставить отзыв, сделайте следующее:

Заполните опрос отзывов клиентов сообщества OpenTelemetry.
Расскажите корпорации Майкрософт о себе, присоединившись к сообществу OpenTelemetry Early Adopter Community.
Взаимодействуйте с другими пользователями Azure Monitor в Microsoft Tech Community.
Отправьте запрос функции на форуме отзывов Azure.

Поддержка

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

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

Следующие шаги

Сведения о исходном коде см. в репозитории Azure Monitor ASP.NET Core GitHub.
Чтобы просмотреть пример приложения, см. статью Azure Monitor OpenTelemetry для ASP.NET Core.
Чтобы установить пакет NuGet, проверить наличие обновлений или просмотреть заметки о выпуске, см. страницу пакета NuGet Azure Monitor AspNetCore.
Дополнительные сведения о OpenTelemetry и его сообществе см. в репозитории OpenTelemetry .NET GitHub.
Чтобы обеспечить пользовательский опыт, включите мониторинг пользователей в Интернете или браузере.

Чтобы просмотреть исходный код, ознакомьтесь с репозиторием Azure Monitor OpenTelemetry для JavaScript.
Чтобы просмотреть пример приложения, см. статью Azure Monitor OpenTelemetry для Node.js.
Чтобы установить пакет npm и проверить наличие обновлений, см. страницу @azure/monitor-opentelemetrynpm Package.
Дополнительные сведения о OpenTelemetry и его сообществе см. в репозитории OpenTelemetry JavaScript GitHub.
Чтобы обеспечить пользовательский опыт, включите мониторинг пользователей в Интернете или браузере.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-13

Поделиться через

Включение Azure Monitor OpenTelemetry для приложений .NET, Node.js, Python и Java

Состояние выпуска OpenTelemetry

Активировать OpenTelemetry с помощью Application Insights

Предварительные условия

Установка клиентской библиотеки

Изменение приложения

Скопируйте строку подключения (connection string) из ресурса Application Insights

Вставьте строку подключения в вашу среду

Подтвердите, что данные поступают

Устранение неполадок, обратная связь и поддержка

Troubleshooting

Отзывы о OpenTelemetry

Поддержка

Следующие шаги

Обратная связь

Дополнительные ресурсы