Usa el panel de métricas de Copilot para una lectura rápida de tendencias de 28 días, la API para análisis repetibles por usuario o repositorio y la exportación NDJSON cuando necesites guardar datos sin depender de la ventana de la interfaz. Las tres superficies parten de telemetría relacionada, pero no son intercambiables fila por fila.
La elección rápida por tarea
| Tarea | Conviene | Motivo |
|---|---|---|
| Revisar adopción sin construir un informe | Panel | Visualiza tendencias y desgloses ya agregados |
| Repetir un cálculo por organización, usuario o repositorio | API | Entrega informes fechados y formas distintas por granularidad |
| Conservar histórico o alimentar BI propio | NDJSON | Permite archivar registros brutos y transformarlos con reglas propias |
La documentación de métricas de GitHub recomienda la API de uso para integraciones nuevas. El panel sigue siendo útil para una decisión rápida; la exportación resuelve otra necesidad: conservar una copia fechada antes de que cambie la ventana disponible.
Condiciones compatibles
| Criterio | Panel | API | NDJSON |
|---|---|---|---|
| Ventana | Gráficos de 28 días y mes actual según métrica | Informes diarios y de 28 días | La que conserves en tus archivos |
| Granularidad | Empresa u organización | Agregada, usuario y repositorio según endpoint | Campos exportados para análisis propio |
| Automatización | Manual | Alta | Depende de tu canal de exportación e ingesta |
| Conservación | Limitada a la interfaz | Descargas con URL firmada temporal | Controlada por tu política y almacenamiento |
| Permisos | Rol autorizado y política habilitada | Rol y permiso de métricas correspondiente | Los de la descarga más los de tu sistema de destino |
Los propietarios de empresa u organización, responsables de facturación y roles personalizados con permiso de lectura pueden acceder según el informe. Además, la política de métricas de Copilot debe estar habilitada. No todos los campos aparecen en todas las formas: un informe por usuario no tiene la misma estructura que uno agregado.
Los cambios del 5 de noviembre
La API ahora indica si falta telemetría del cliente y si IDE o extensiones están por debajo de las versiones mínimas. Un usuario puede aparecer a la vez en ambos grupos, por lo que no debes sumar los dos recuentos para obtener personas únicas. Tampoco sumes los recuentos diarios como si fueran usuarios distintos.
Los informes por repositorio añaden un objeto de revisión de código con comentarios evaluados y atendidos, desgloses por gravedad y nivel, y pull requests fusionados sin una petición humana posterior de cambios. La tasa atendida se calcula dividiendo comentarios atendidos entre comentarios evaluados. GitHub la computa al fusionar el pull request, no el día en que Copilot publicó el comentario.
Cuatro errores que cambian la conclusión
- Tratar null como cero. Un valor nulo u omitido significa que no está disponible; los días anteriores al lanzamiento no tienen estos campos.
- Sumar personas entre días. Los recuentos diarios no forman una población única del periodo.
- Confundir actividad con impacto. Una sugerencia atendida no prueba que el cambio fuera correcto ni que ahorrara tiempo.
- Comparar recursos distintos. Informes de uso, gestión de asientos y facturación tienen modelos de datos y fines diferentes.
La guía sobre skills, agentes y MCP en las métricas explica por qué una lista limitada de personalizaciones tampoco es un inventario completo. Esta comparación aborda otra decisión: dónde obtener y conservar los datos.
GitHub no cobra una tarifa separada publicada por consultar estas superficies, pero el acceso depende del plan y de los permisos de Copilot de la organización. La documentación no convierte los campos en una medición causal de productividad.
Transparencia: comparación elaborada con asistencia de IA a partir de documentación y changelogs oficiales. Texploto no accedió a datos de una organización ni ejecutó la API.
