OpenTelemetry (OTel) é uma estrutura de observabilidade código aberto. Ele fornece uma maneira padrão de coletar eventos e métricas de telemetria e exportá-los para ferramentas de observabilidade compatíveis. Para obter mais informações, consulte o que é OpenTelemetry? no site da OTel.
Ao habilitar o monitoramento OTel, você pode enviar dados dos clientes Copilot dos usuários para um backend compatível com OTel. Isso permite que você analise as sessões do agente e entenda o uso do agente em sua empresa.
Que dados Copilot envia?
Copilot envia três tipos de dados:
- Os rastreamentos mostram o fluxo de uma sessão de agente e conectam cada etapa, incluindo chamadas de modelo e uso de ferramentas. Por exemplo, um rastreamento pode mostrar um agente chamando um modelo, usando a
readFileferramenta e chamando o modelo novamente para produzir uma resposta. - As métricas são medidas numéricas que ajudam a identificar padrões ao longo do tempo. Por exemplo, as métricas de uso de token acompanham o número de tokens de entrada e saída usados em chamadas de modelo.
- Os eventos registram ações individuais em um ponto específico no tempo. Por exemplo, um evento de feedback de edição registra se um usuário aceitou ou rejeitou uma edição feita por um agente.
Por padrão, os dados não incluem prompts, respostas ou argumentos de ferramenta. Você pode optar por capturar esse conteúdo, mas ele pode conter informações confidenciais, como código, conteúdo de arquivo e prompts do usuário.
Habilitando o OpenTelemetry
Para coletar dados do OTel dos clientes dos usuários Copilot:
- Configure um back-end de observabilidade. Escolha um back-end seguro que dê suporte ao Protocolo OpenTelemetry (OTLP). Alguns back-ends podem receber dados OTLP diretamente. Para outros back-ends, implante um Coletor OpenTelemetry para receber, processar e encaminhar os dados. Para ver exemplos, consulte Usar com backends de observabilidade na documentação de VS Code.
- Configure os clientes dos usuários. Defina valores de configuração para habilitar o OTel em cada cliente e configure-o para enviar dados para o ponto de extremidade OTLP configurando o ponto de extremidade, os cabeçalhos e o token de autenticação.
- Interpretar dados. Use os dados coletados para analisar sessões e identificar tendências. Para ver um exemplo de implementação, consulte Monitor AI coding agents with Grafana na documentação da Microsoft.
Configurando os clientes dos usuários
As empresas podem aplicar a configuração do OTel em todos os clientes compatíveis usando configurações gerenciadas. Essas configurações são impostas entre os clientes dos usuários e não podem ser substituídas. A telemetry propriedade inclui chaves para habilitar e configurar o OpenTelemetry.
Para obter mais informações, consulte Configurando configurações gerenciadas pela empresa e Configurações gerenciadas pela empresa.
Documentação do cliente
Para obter mais detalhes de como o OpenTelemetry é usado entre clientes, consulte: