El panel de métricas de uso de Copilot, las API y los archivos de exportación utilizan los mismos datos de telemetría subyacentes, pero los agregan y presentan de forma diferente. Comprender estas diferencias le ayuda a conciliar los números entre orígenes y confiar en el análisis al preparar informes internos.
- Los paneles de métricas de uso Copilot están disponibles a nivel de empresa y organización.
- Las API de métricas de uso de Copilot admiten registros a nivel de empresa, organización y usuario.
Prerrequisito
Las métricas de uso de Copilot basadas en IDE dependen de la telemetría de los IDE de los usuarios. Si un desarrollador ha deshabilitado la telemetría en su IDE, la actividad basada en Copilot en el IDE no aparecerá en el panel, los informes de API ni en los datos exportados.
Si observa que faltan usuarios o números de adopción inesperados bajos, compruebe la configuración de telemetría del IDE antes de solucionar otras causas.
Las métricas CLI de Copilot (daily_active_cli_users y totals_by_cli) se recopilan y comunican por separado de la telemetría IDE. El uso de la CLI no contribuye a los recuentos de usuarios activos basados en IDE ni a otras métricas del IDE.
Alineación de métricas
El panel y las API usan definiciones compartidas para las métricas clave:
| Concepto | Métrica del panel de control | Campo de la API o de exportación | Notas |
|---|---|---|---|
| Usuarios activos | Usuarios activos diarios, semanales o totales | user_initiated_interaction_count > 0 | Un usuario se considera activo si interactúa con Copilot en su IDE en ese día. |
| Tasa de aceptación | Tasa de aceptación de finalización de código |
`code_acceptance_activity_count` ÷ `code_generation_activity_count` | Ambos orígenes calculan la tasa de aceptación del mismo modo, aunque el redondeo puede diferir. |
| Adopción de agente | Gráfico de adopción del agente |
totals_by_feature donde feature = "agent" | Refleja los usuarios que interactuaron con agente de Copilot. |
| Uso de idiomas | Gráficos de uso de idioma |
totals_by_language_feature o totals_by_language_model | El panel visualiza estos campos agregados. |
Para obtener descripciones de campo completas, consulte métricas de uso de GitHub Copilot.
Discrepancias entre informes
Se esperan pequeñas diferencias entre los datos del panel, los informes de API y las exportaciones. Estas variaciones suelen deberse a diferencias en las ventanas de tiempo, el ámbito o la actualización de datos.
Ventanas de plazo
Cada origen de datos agrega datos de forma diferente.
| Fuente | Período de tiempo | Método de agregación |
|---|---|---|
| Dashboard | Ventana gradual de 28 días | Las métricas se agregan continuamente en los últimos 28 días para suavizar las fluctuaciones. |
| APIs (Interfaz de Programación de Aplicaciones) | Diariamente | Cada registro representa un solo día por usuario, lo que permite el análisis de tendencias diario. |
| Exportaciones de NDJSON | Diariamente | Muestra los resultados de la API para las herramientas de inteligencia empresarial y los informes de largo plazo. |
Alinear el período de informes con la ventana de 28 días del panel garantiza comparaciones coherentes.
Telemetría retrasada
Dado que la telemetría del IDE se procesa de forma asincrónica, es posible que los datos de los últimos días aparezcan incompletos o que falten. Normalmente, los datos finalizan en tres días UTC completos. Las caídas aparentes en las métricas diarias recientes a menudo se resuelven una vez que la telemetría se procesa por completo.
Tiempo de exportación
Los archivos NDJSON reflejan los datos disponibles en el momento de la exportación. Si se descarga un archivo antes de procesar nuevos datos de telemetría, los datos pueden tener un retraso respecto al panel de control o la API. Volver a exportar el archivo después de la ventana de tres días proporciona la vista más precisa.
`Unknown` valores
El valor Unknown aparece en algunos desgloses de api o exportación cuando la telemetría del cliente IDE carece de detalles suficientes para clasificar la actividad. Este es el comportamiento esperado y no indica los datos que faltan.
| Desglose | Explanation |
|---|---|
| Language | Se muestra como Unknown cuando el IDE no puede identificar el lenguaje de programación del archivo activo. |
| Característica | Aparece cuando un cliente anterior envía un evento genérico sin especificar un modo de chat (por ejemplo, chat_panel_unknown_mode). |
| Modelo | Aparece cuando el evento carece de información que identifica el modelo usado. Algunos modelos internos (por ejemplo, gpt-4o-mini) pueden aparecer junto con Unknown cuando se usan para operaciones no orientadas al usuario, como la detección de resúmenes o intenciones. |
`Unknown` Los valores se excluyen de las visualizaciones del panel, pero aparecen en los datos de API y NDJSON por integridad. La cantidad de datos `Unknown` disminuye a medida que los usuarios actualizan a versiones más recientes del IDE y la extensión que envían telemetría más rica.