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

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

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

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

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

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

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

Примечание.

Сведения о приложениях-функциях Azure см. в разделе Use OpenTelemetry с Функции Azure.

Активировать 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.

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

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

Совет

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

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

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

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

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

Внимание

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

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

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

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

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

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

Примечание.

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

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

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

Запустите приложение, а затем откройте 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 в Майкрософт Tech Community.
Отправьте запрос на функцию на форуме отзывов Azure.

Поддержка

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

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

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

Сведения о исходном коде см. в репозитории 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-04-11

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

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

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

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

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

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

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

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

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

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

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

Troubleshooting

Отзывы о OpenTelemetry

Поддержка

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

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

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