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