Автоматическое сбор данных и детекторы ресурсов для Azure Monitor OpenTelemetry

В этой статье объясняется, как Azure Monitor OpenTelemetry автоматически собирает данные телеметрии и как детекторы ресурсов обогащают данные телеметрии согласованными метаданными. Вы узнаете, какие сигналы собираются по умолчанию и как детекторы ресурсов заполняют такие атрибуты, как идентификаторы службы и сведения о среде, чтобы данные в Application Insights было проще фильтровать, сопоставлять и устранять неполадки в приложениях на .NET, Java, Node.js и Python.

Дополнительные сведения о концепциях OpenTelemetry см. в обзоре OpenTelemetry.

Замечание

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

Включенные библиотеки инструментирования

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

ASP.NET Core

Запросы

• ASP.NET Core 8

Зависимости

• HttpClient ¹
• SqlClient ¹
• Azure SDK

Логирование

• ILogger

Для получения дополнительной информации о ILogger см. Logging в C# и .NET и примеры кода.

.NET

Экспортер Azure Monitor не включает библиотеки инструментирования.

Чтобы собрать зависимости из комплектов разработки программного обеспечения (SDK) Azure, используйте следующий пример кода для подписки на источник вручную.

// Create an OpenTelemetry tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
using var tracerProvider = Sdk.CreateTracerProviderBuilder()
	// The following line subscribes to dependencies emitted from Azure SDKs
    .AddSource("Azure.*")
    .AddAzureMonitorTraceExporter()
    .AddHttpClientInstrumentation(o => o.FilterHttpRequestMessage = (_) =>
	{
    	// Azure SDKs create their own client span before calling the service using HttpClient
		// In this case, we would see two spans corresponding to the same operation
		// 1) created by Azure SDK 2) created by HttpClient
		// To prevent this duplication we are filtering the span from HttpClient
		// as span from Azure SDK contains all relevant information needed.
		var parentActivity = Activity.Current?.Parent;
		if (parentActivity != null && parentActivity.Source.Name.Equals("Azure.Core.Http"))
		{
		    return false;
		}
		return true;
	})
    .Build();

Java

Запросы

• потребители службы сообщений Java (JMS)
• Потребители Kafka
• Netty;
• Кварц
• RabbitMQ
• Сервлеты
• Планирование в Spring

Замечание

Servlet и Netty autoinstrumentation охватывают большинство Java HTTP-служб, включая Java EE, Jakarta EE, Spring Boot, Quarkus и Micronaut.

Зависимости (плюс последующее распространение распределенной трассировки)

• Apache HttpClient
• Apache HttpAsyncClient
• AsyncHttpClient
• Google HttpClient
• gRPC
• java.net.HttpURLConnection
• Java 11 HttpClient
• Клиент JAX-RS
• Jetty HTTP-клиент
• JMS;
• Kafka
• Клиент Netty
• OkHttp;
• RabbitMQ

Зависимости (без распространения трассировки на последующих этапах)

• Поддерживает Cassandra
• Поддерживает подключение к базе данных Java (JDBC)
• Поддерживает MongoDB (асинхронную и синхронную синхронизацию)
• Поддерживает Redis (Lettuce и Jedis)

Метрики

• Метрики микрометра, включая метрики Spring Boot Actuator
• Метрики расширений управления Java (JMX)

Логи

• Logback (включая свойства MDC)
• Log4j (включая свойства контекста MDC/Thread) NO
• Ведение журнала JBoss (включая свойства MDC)
• java.util.logging

Коллекция по умолчанию

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

• Конфигурация приложений Azure 1.1.10+
• Поиск с использованием ИИ Azure 11.3.0+
• Azure Communication Chat 1.0.0+
• Azure Communication Common 1.0.0+
• Azure Communication Identity 1.0.0+
• Номера телефонов Azure Communication 1.0.0+
• Azure sms (служба коротких сообщений) 1.0.0+
• Azure Cosmos DB 4.22.0+
• Azure Digital Twins — Core 1.1.0+
• Сетка событий Azure 4.0.0+
• Центры событий Azure 5.6.0+
• Центры событий Azure — хранилище контрольных точек Хранилище BLOB-объектов Azure 1.5.1+
• Интеллектуальный анализ документов ИИ Azure 3.0.6+
• Azure Identity 1.2.4+
• Azure Key Vault — сертификаты 4.1.6+
• Azure Key Vault — ключи 4.2.6+
• Azure Key Vault — секреты 4.2.6+
• Служебная шина Azure 7.1.0+
• служба хранилища Azure — Blob 12.11.0+
• служба хранилища Azure - Пакетная обработка объектов BLOB 12.9.0+
• служба хранилища Azure — криптография больших двоичных объектов 12.11.0+
• служба хранилища Azure — Common 12.11.0+
• служба хранилища Azure — файлы Озеро данных 12.5.0+
• служба хранилища Azure — общие папки 12.9.0+
• служба хранилища Azure — очереди 12.9.0+
• Azure Анализ текста 5.0.4+

Java native

Запросы для собственных приложений Spring Boot

• Spring Web
• Spring Web MVC (model-View-Controller)
• Spring WebFlux

Зависимости для собственных приложений Spring Boot

• JDBC
• R2DBC
• MongoDB
• Kafka
• Azure SDK

Метрики

• Метрики микрометра

Журналы для нативных приложений Spring Boot

• Обратный вход

См. документацию Quarkus для родных приложений Quartz.

Замечание

Сообщество Quarkus поддерживает и обслуживает расширения Quarkus. Для получения справки используйте каналы поддержки сообщества Quarkus. Майкрософт не предоставляет техническую поддержку этой интеграции.

Node.js

Подсказка

примеры TypeScript для Azure Monitor OpenTelemetry (авторитетный источник параллельности): https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry/samples-dev

Дистрибутив Azure Monitor Application Insights включает следующие библиотеки OpenTelemetry для инструментирования. Дополнительные сведения см. в разделе Azure SDK для JavaScript.

Запросы

• HTTP/HTTPS²

Зависимости

• MongoDB
• MySQL
• Postgres
• Редис
• Редис-4
• Azure SDK

Логи

• Bunyan
• Winston

Это важно

По умолчанию Bunyan и Winston не включены. Библиотеки инструментирования можно включить, установив значение enabled: true в параметрах инструментирования.

Разверните, чтобы просмотреть пример кода, в который показано, как настроить инструментирование с помощью AzureMonitorOpenTelemetryOptions.

import { useAzureMonitor, AzureMonitorOpenTelemetryOptions } from "@azure/monitor-opentelemetry";
import bunyan from "bunyan";

// Call useAzureMonitor before importing other libraries
const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
    connectionString:
      process.env.APPLICATIONINSIGHTS_CONNECTION_STRING ||
      "<your-connection-string>",
  },
  // Bunyan is disabled by default — explicitly enable it
  instrumentationOptions: {
    bunyan: { enabled: true },
  },
};

useAzureMonitor(options);

// Create a bunyan logger as usual logs are automatically captured
const logger = bunyan.createLogger({ name: "my-app" });

logger.info("Application started");
logger.warn({ requestId: "abc-123" }, "Slow response detected");
logger.error(new Error("Something failed"), "Unhandled error");

Python

Запросы

• Django ¹
• FastApi ¹
• Flask ¹

Зависимости

• Psycopg2
• Запросы ¹
• Urllib ¹
• Urllib3 ¹

Логи

• библиотека логирования Python

Примеры использования библиотеки ведения журнала Python можно найти в GitHub.

Данные телеметрии, генерируемые пакетами SDK Azure, автоматически собираются по умолчанию.

сноски

• Поддерживает автоматическую отчетность необработанных/неперехваченных исключений.
• 2. Поддерживает метрики OpenTelemetry

Замечание

Дистрибутивы OpenTelemetry Azure Monitor включают настраиваемое сопоставление и логику для автоматической отправки Стандартные метрики Application Insights. Для целей выставления счетов все метрики OpenTelemetry( автоматически собранные из библиотек инструментирования или вручную собранные из пользовательского кода) в настоящее время считаются пользовательскими метриками Application Insights. Подробнее.

Подсказка

Чтобы уменьшить или увеличить количество журналов, отправленных в Azure Monitor, настройте ведение журнала, чтобы задать соответствующий уровень журнала или применить фильтры. Например, можно отправить только журналы WARNING и ERROR в Azure Monitor.

Детекторы ресурсов

Детекторы ресурсов обнаруживают метаданные среды при запуске и заполняют атрибуты ресурсов OpenTelemetry, например service.name, cloud.providerи cloud.resource_id. Эти метаданные позволяют выполнять такие функции в Application Insights, как карта приложений и связывание вычислений, а также улучшает корреляцию между трассировками, метриками и журналами.

Подсказка

Атрибуты ресурсов описывают процесс и ее среду. Атрибуты диапазона описывают одну операцию. Используйте атрибуты ресурсов для свойств уровня приложения, таких как service.name.

Поддерживаемые среды

Окружающая среда	Принцип работы обнаружения	Примечания.
Служба приложений Azure	Языковой SDK или дистрибутив Azure Monitor считывает известные переменные среды App Service и метаданные узла.	Работает с .NET, Java, Node.jsи Python при использовании инструкций в этой статье.
Функции Azure	См. руководство Функции Azure OpenTelemetry	Все инструкции по Функции Azure находятся там.
Виртуальные машины Azure	Языковой пакет SDK или дистрибутив запрашивает службу метаданных экземпляра Azure	Убедитесь, что виртуальная машина имеет доступ к конечной точке службы метаданных экземпляра.
Azure Kubernetes Service (AKS)	Используйте процессор OpenTelemetry Collector k8sattributes для добавления метаданных Kubernetes	Рекомендуется для всех языков, работающих в AKS.
Контейнеры приложений Azure	Детекторы сопоставляют переменные среды и идентификаторы ресурсов при наличии	Вы также можете задать OTEL_RESOURCE_ATTRIBUTES для заполнения пробелов.

Рекомендации по приему OTLP

• cloud.resource_id улучшает связывание вычислений с Azure ресурсами. Если этот атрибут отсутствует, некоторые интерфейсы могут не отображать ресурс Azure, создающий данные.

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

• cloud.resource_id улучшает связывание вычислений с Azure ресурсами. Если этот атрибут отсутствует, некоторые интерфейсы могут не отображать ресурс Azure, создающий данные.

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

Подсказка

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

Troubleshooting

ASP.NET Core

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

.NET

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

Java

Сведения об устранении неполадок см. в разделе Устранение неполадок OpenTelemetry в Java и Устранение неполадок отсутствия телеметрии приложений в Azure Monitor Application Insights.

Java native

Сведения об устранении неполадок см. в разделах Устранение неполадок OpenTelemetry в приложениях образов Spring Boot и Устранение отсутствия телеметрии приложений в Azure Monitor Application Insights.

Node.js

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

Python

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

Отзывы о OpenTelemetry

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

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

Поддержка

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

ASP.NET Core

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

.NET

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

Java

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

Java native

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

Замечание

Сообщество Quarkus поддерживает и обслуживает расширения Quarkus. Для получения справки используйте каналы поддержки сообщества Quarkus. Майкрософт не предоставляет техническую поддержку этой интеграции.

Node.js

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

Python

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

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

ASP.NET Core

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

.NET

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

Java

• Чтобы ознакомиться с параметрами конфигурации, см. раздел Параметры конфигурации автоинструментации в Java.
• Чтобы просмотреть исходный код, см. репозиторий GitHub для автоинструментирования Azure Monitor Java.
• Сведения о примерах приложений см. в статье Application Insights Java Samples.
• Просмотрите заметки релиза на GitHub.
• Дополнительные сведения о OpenTelemetry и его сообществе см. в репозитории OpenTelemetry Java GitHub.
• Чтобы включить возможности использования, ознакомьтесь со сведениями о включении мониторинга пользователей в Интернете или браузере.

Java native

• Чтобы просмотреть исходный код, см. статью Azure Monitor Дистрибутив OpenTelemetry в собственном образе Spring Boot Java приложения и Quarkus OpenTelemetry Exporter для Azure.
• Чтобы просмотреть пример приложения, см. статью Telemetry для нативных образов GraalVM.
• Просмотрите заметки о выпуске на GitHub.
• Узнайте больше о возможностях для приложений на основе образов Spring Boot с помощью стартер OpenTelemetry SpringBoot
• Дополнительные возможности для собственных приложений Quarkus см. в Quarkus OpenTelemetry Exporter для Azure.
• Дополнительные сведения о OpenTelemetry и его сообществе см. в репозитории OpenTelemetry Java GitHub.

Node.js

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

Python

• Дополнительные сведения о исходном коде и дополнительной документации см. в репозитории Azure Monitor Python GitHub.
• Сведения о примерах приложений см. в разделе Azure Monitor OpenTelemetry для Python.
• Чтобы установить пакет PyPI и проверить наличие обновлений, см. страницу дистрибутива Azure Monitor PyPI-пакета.
• Просмотрите заметки о релизе на GitHub.
• Сведения о доступных инструментах и компонентах OpenTelemetry см. в репозитории OpenTelemetry Contributor Python GitHub.
• Дополнительные сведения о OpenTelemetry и его сообществе см. в репозитории OpenTelemetry Python GitHub.
• Чтобы обеспечить пользовательский опыт, включите мониторинг пользователей в Интернете или браузере.