O painel de métricas de uso do Copilot, os APIs e os arquivos de exportação usam os mesmos dados de telemetria subjacentes, mas os agregam e apresentam de maneira distinta. Entender essas diferenças ajuda você a reconciliar números entre fontes e confiar em sua análise ao preparar relatórios internos.
- Os painéis de métricas de uso do Copilot estão disponíveis nos níveis de empresa e organização.
- As APIs de métricas de uso Copilot suportam registros de nível empresarial, organizacional e de usuário.
Pré-requisito
As métricas de uso do Copilot baseadas em IDE dependem da telemetria dos IDEs dos usuários. Se um desenvolvedor tiver desabilitado a telemetria no seu IDE, a atividade no IDE do Copilot não aparecerá no painel, nos relatórios da API ou nos dados exportados.
Se você observar usuários ausentes ou números de adoção inesperadamente baixos, verifique as configurações de telemetria do IDE antes de solucionar outras causas.
As métricas CLI do Copilot (daily_active_cli_users e totals_by_cli) são coletadas e relatadas separadamente da telemetria do IDE. O uso da CLI não contribui para contagens de usuários ativos baseadas em IDE ou outras métricas de IDE.
Alinhamento de métricas
O painel e as APIs usam definições compartilhadas para as principais métricas:
| Conceito | Métrica de painel de controle | API ou campo de exportação | Anotações |
|---|---|---|---|
| Usuários ativos | Usuários ativos diários/semanais/totais |
`user_initiated_interaction_count` > 0 | Um usuário será considerado ativo se tiver interagido com Copilot em seu IDE naquele dia. |
| Taxa de aceitação | Taxa de aceitação de conclusão de código |
code_acceptance_activity_count ÷ code_generation_activity_count | Ambas as fontes calculam a taxa de aceitação da mesma maneira, embora o arredondamento possa ser diferente. |
| Adoção do agente | Gráfico de adoção do agente |
totals_by_feature em que o recurso = "agent" | Reflete usuários que interagiram com o agente do Copilot. |
| Uso do idioma | Gráficos de uso de idioma |
totals_by_language_feature ou totals_by_language_model | O painel visualiza esses campos agregados. |
Para obter descrições de campo completas, consulte GitHub métricas de uso do Copilot.
Discrepâncias entre relatórios
Pequenas diferenças entre dados de dashboard, relatórios de API e exportações são esperadas. Essas variações geralmente são causadas por diferenças nas janelas de tempo, escopo ou atualização de dados.
Janelas de horas
Cada fonte de dados agrega dados de forma diferente.
| Source | Janela de tempo | Método de agregação |
|---|---|---|
| Dashboard | Janela móvel de 28 dias | As métricas são agregadas continuamente nos últimos 28 dias para suavizar as flutuações. |
| APIs | Diariamente | Cada registro representa um único dia por usuário, habilitando a análise de tendência diária. |
| Exportações NDJSON | Diariamente | Espelha a saída da API para ferramentas de BI e relatórios de longo prazo. |
Alinhar o período de relatório com a janela de 28 dias do painel garante comparações consistentes.
Telemetria atrasada
Como a telemetria IDE é processada de forma assíncrona, os dados dos últimos dias podem parecer incompletos ou ausentes. Normalmente, os dados são finalizados em três dias UTC completos. As quedas aparentes nas métricas diárias recentes geralmente são resolvidas quando a telemetria é totalmente processada.
Tempo de exportação
Os arquivos NDJSON refletem os dados disponíveis no momento da exportação. Se um arquivo for baixado antes que a nova telemetria seja processada, os dados poderão ficar atrás do painel ou da API. A exportação nova do arquivo após a janela de três dias fornece a exibição mais precisa.
`Unknown` Valores
O valor Unknown aparece em alguns detalhamentos de API ou exportação quando a telemetria do cliente da IDE carece de detalhes suficientes para categorizar a atividade. Esse é o comportamento esperado e não indica dados ausentes.
| Detalhamento | Explanation |
|---|---|
| Linguagem | Mostrado como Unknown quando o IDE não pode identificar a linguagem de programação do arquivo ativo. |
| Característica | Aparece quando um cliente mais antigo envia um evento genérico sem especificar um modo de chat (por exemplo, chat_panel_unknown_mode). |
| Modelo | Aparece quando o evento não tem informações que identifiquem o modelo usado. Alguns modelos internos (por exemplo, gpt-4o-mini) podem aparecer ao lado Unknown quando usados para operações não voltadas para o usuário, como resumo ou detecção de intenção. |
`Unknown` os valores são excluídos das visualizações do painel, mas aparecem nos dados de API e NDJSON para fins de integridade. A quantidade de `Unknown` dados diminui à medida que os usuários atualizam para versões mais recentes do IDE e de extensão que enviam telemetria mais avançada.