Сбор данных OpenTelemetry (OTel) для взаимодействия с Application Insights

В этой статье рассматривается начало работы с сбором данных Application Insights .

К точкам входа относятся:

• Серверные веб-приложения
• Серверные веб-приложения, размещенные на виртуальной машине
• Клиентские приложения JavaScript
• Azure Functions
• Агенты ИИ

Начало работы

Выберите вкладку, которая лучше всего соответствует вашей рабочей нагрузке или модели размещения.

Большинство сценариев на стороне сервера в этой статье используют Azure Monitor OpenTelemetry.

Веб-приложения

Используйте этот путь для серверных веб-приложений, которые вы инструментируете в коде.

1. Создайте ресурс Application Insights.
2. Получите строку подключения ресурса.
3. Добавьте дистрибутив OpenTelemetry в приложение.
4. Настройте строку подключения.

Совет

Некоторые платформы позволяют автоматически собирать данные с помощью автоинструментации. Переключитесь на инструментирование на основе кода с помощью дистрибутива OpenTelemetry , если требуется больше параметров конфигурации и расширяемости.

VM

Используйте этот путь при запуске приложения на виртуальной машине или масштабируемом наборе виртуальных машин. Поток, основанный на коде, такой же, как у других серверных приложений.

1. Создайте ресурс Application Insights.
2. Получите строку подключения ресурса.
3. Добавьте дистрибутив OpenTelemetry в приложение.
4. Настройте строку подключения.

Совет

Некоторые платформы позволяют автоматически собирать данные с помощью автоинструментации. Переключитесь на инструментирование на основе кода с помощью дистрибутива OpenTelemetry , если требуется больше параметров конфигурации и расширяемости.

JavaScript

Используйте этот путь для телеметрии браузера, например, просмотров страниц и пользовательских взаимодействий. Приложения браузера используют пакет SDK JavaScript Application Insights, а не OpenTelemetry.

1. Создайте ресурс Application Insights.
2. Получите строку подключения ресурса.
3. Добавьте пакет SDK JavaScript в приложение.
4. Настройте строку подключения.

Примечание.

Пакет SDK JavaScript для Application Insights не использует OpenTelemetry. Дополнительные сведения см. в статье "Можно ли использовать OpenTelemetry для веб-браузеров?

Функции

Используйте этот путь для Azure Functions. Начните с параметров приложения-функции, а затем следуйте инструкциям в статье "Функции" для конкретных языков.

1. Включите OpenTelemetry в файле приложения-функции host.json , задав параметр "telemetryMode": "OpenTelemetry".
2. Добавьте параметр APPLICATIONINSIGHTS_CONNECTION_STRINGapplication с помощью Application Insights connection string.
3. Выполните инструментирование для конкретного языка и настройте необходимые параметры работника в Use OpenTelemetry with Azure Functions.

Примечание.

OpenTelemetry в настоящее время не поддерживается для приложений в процессе C#.

Kubernetes

Используйте этот путь для приложений, работающих на Azure Kubernetes Service (AKS). Поток, основанный на коде, такой же, как у других серверных приложений.

1. Создайте ресурс Application Insights.
2. Получите строку подключения ресурса.
3. Добавьте дистрибутив OpenTelemetry в приложение.
4. Настройте строку подключения (connection string).

Примечание.

Автоматическое инструментирование для Azure Kubernetes Service (AKS) доступно в виде общедоступной предварительной версии.

Агенты

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

• Управляемое размещение

  • Azure AI Foundry: для агентов и рабочих процессов, управляемых Foundry, начните с настройки трассировки в Foundry. Для инструментирования на стороне приложения можно также использовать дистрибутив OpenTelemetry Azure Monitor с пакетом SDK Foundry.
  • Copilot Studio: Используйте встроенную конфигурацию для отправки данных телеметрии в Azure Monitor. Дополнительные сведения см. в разделе Connect your Copilot Studio agent to Application Insights.

• Самостоятельное размещение

  • Microsoft Agent Framework: Если вы создаете агента с нуля для самостоятельного размещения, используйте Microsoft Agent Framework для оркестрации агента и отправки данных телеметрии в Azure Monitor.
  • Сторонние агенты: Если вы создали агента в другом месте, используйте Azure AI OpenTelemetry Tracer для передачи телеметрии в Azure Monitor. Эти агенты также можно зарегистрировать в Azure AI Foundry. Для получения инструкций для конкретной платформы см. раздел «Включение трассировки для агентов, созданных на основе LangChain и LangGraph» и «Включение трассировки для агентов, созданных на основе пакета SDK для агентов OpenAI».

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

Если вы решили собирать полные сведения о запросах, например с помощью флага EnableSensitiveData в Agent Framework, можно выполнять поиск по запросам в представлении поиска и просматривать беседы, включая сообщения помощника, системные запросы и использование инструментов в представлении сведений о транзакциях .

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

Если вы также хотите просмотреть агентов в Azure AI Foundry в дополнение к Azure Monitor, подключите ресурс Application Insights к проекту Foundry.

Вы также можете настроить оценки следующим образом:

• Пакетная оценка
  • Локальные оценки с использованием Azure AI Evaluation SDK:Выполняйте оценки на вашей рабочей машине в процессе тестирования.
  • Оценки в облаке с помощью пакета SDK Foundry:Выполняйте оценки в Azure для больших наборов данных или для совместной работы в команде.
  • Оценки на основе портала foundry:используйте портал Foundry для рабочих процессов оценки без кода.
• Непрерывная оценка:настройка автоматических вычислений, выполняемых в рабочей среде для обнаружения регрессий качества.

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

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

Ознакомьтесь со следующими ресурсами, чтобы узнать больше о концепциях Application Insights.

аутентификация Microsoft Entra для Application Insights

Отслеживание зависимостей в Application Insights

Метрики в Application Insights

Модель данных телеметрии Application Insights

Обзор рабочей области Log Analytics

Tutorial: используйте Log Analytics