OpenTelemetry (OTel) — это платформа открытый код наблюдаемости. Он предоставляет стандартный способ сбора событий телеметрии и метрик и их экспорта в совместимые средства наблюдения. Дополнительные сведения см. в разделе "Что такое OpenTelemetry?" на веб-сайте OTel.
При включении мониторинга OTel можно отправлять данные от клиентов пользователей Copilot в серверную часть, совместимую с OTel. Это позволяет анализировать сеансы агента и понимать использование агента в организации.
Какие данные Copilot отправляются?
Copilot отправляет три типа данных:
- Трассировки показывают поток сеанса агента и подключают каждый шаг, включая вызовы модели и использование инструментов. Например, трассировка может показать агент, вызывающий модель, используя
readFileсредство, и снова вызвать модель для получения ответа. - Метрики — это числовые измерения, которые помогают выявлять шаблоны с течением времени. Например, метрики использования маркеров отслеживают количество входных и выходных маркеров, используемых в вызовах модели.
- События записывают отдельные действия в определенный момент времени. Например, событие изменения обратной связи записывает, принимает ли пользователь или отклоняет изменение агента.
По умолчанию данные не включают запросы, ответы или аргументы инструментов. Вы можете записать это содержимое, но оно может содержать конфиденциальную информацию, например код, содержимое файла и запросы пользователей.
Включение OpenTelemetry
Чтобы собирать данные OTel от клиентов пользователей Copilot , выполните приведенные ниже действия.
- Настройте серверную часть наблюдаемости. Выберите безопасную серверную часть, которая поддерживает протокол OpenTelemetry (OTLP). Некоторые серверные части могут напрямую получать данные OTLP. Для других серверных компонентов разверните сборщик OpenTelemetry для получения, обработки и пересылки данных. Примеры см. в разделе "Использование с серверными серверами с наблюдаемостью " в VS Code документации.
- Настройте клиенты пользователей. Задайте значения конфигурации, чтобы включить OTel в каждом клиенте и настроить его для отправки данных в конечную точку OTLP, настроив конечную точку, заголовки и маркер проверки подлинности.
- Интерпретация данных. Используйте собранные данные для анализа сеансов и выявления тенденций. Пример реализации см. в разделе "Мониторинг агентов программирования ИИ" с помощью Grafana в документации по Microsoft.
Настройка клиентов пользователей
Предприятия могут применять конфигурацию OTel для поддерживаемых клиентов с управляемыми параметрами. Эти параметры применяются для клиентов пользователей и не могут быть переопределены. Свойство telemetry содержит ключи для включения и настройки OpenTelemetry.
Дополнительные сведения см. в разделе [AUTOTITLE и Настройка параметров, управляемых предприятием](/copilot/reference/enterprise-administrators/enterprise-managed-settings).
Документация клиента
Дополнительные сведения об использовании OpenTelemetry для клиентов см. в следующих статье: