- GitHub ofrece informes avanzados sobre API, proyectos, comunidad, tráfico, facturación y código para entender a fondo la actividad de una organización.
- Los roles personalizados y las distintas vistas de Insights permiten compartir estos datos con los equipos adecuados sin dar permisos de administración excesivos.
- Las métricas de facturación y de GitHub Actions ayudan a controlar costes, optimizar flujos de trabajo y equilibrar el uso de minutos entre distintos repositorios y ejecutores.
- Combinando todos los insights es posible detectar cuellos de botella, mejorar la colaboración y tomar decisiones basadas en datos sobre el desarrollo y la operación de los repositorios.
Si manejas una organización en GitHub Enterprise Cloud, los informes e insights de GitHub son tu panel de control para entender qué está pasando realmente con tu código, tu equipo y tus recursos. No se trata solo de gráficos bonitos: son datos accionables sobre API, proyectos, debates, tráfico, facturación, commits y GitHub Actions que te ayudan a tomar decisiones con fundamento.
Además de las vistas básicas que ya conoces, GitHub ofrece un conjunto muy potente de secciones de “Insights” y métricas especializadas que muchas organizaciones apenas tocan. Bien configuradas, permiten detectar cuellos de botella, controlar el gasto, optimizar flujos de trabajo y medir la salud de tu comunidad técnica sin tener que montar un sistema de analítica desde cero.
Informes de actividad de la API REST en la organización
Como propietario de una organización en GitHub Enterprise Cloud tienes acceso a informes detallados de uso de la API REST, tanto a nivel global de la organización como filtrando por aplicaciones o por usuarios concretos. Esta visibilidad es clave para entender de dónde viene la actividad de API y cómo se consumen los límites de volumen principales (rate limits) definidos por GitHub.
Estos insights de API te permiten ver, para un periodo determinado, qué aplicaciones GitHub Apps y qué usuarios están realizando peticiones, a qué endpoints se accede con más frecuencia y en qué franjas temporales se concentran los picos. Con esta información puedes detectar integraciones mal diseñadas, automatizaciones demasiado agresivas o posibles abusos antes de que lleguen a bloquearte por límite de uso.
GitHub te deja ajustar el periodo de análisis con rangos predefinidos o un intervalo personalizado de fechas. Por defecto, todos los datos se muestran en hora universal coordinada (UTC), pero puedes cambiar la vista a la zona horaria local de tu navegador desde el desplegable “Period” en la parte superior derecha de la página de insights de API, lo que facilita interpretar correctamente los picos de actividad en función de tu horario laboral.
Para acceder a estas conclusiones de la API a nivel de organización, el flujo es muy sencillo: vas a tu foto de perfil, entras en “Your organizations”, eliges la organización y luego la pestaña “Insights”. Dentro del menú de navegación de Insights encontrarás la sección “REST API”, donde se muestra el gráfico principal de actividad y los controles de periodo, intervalo y zona horaria.
Además del periodo, puedes elegir el nivel de detalle con el desplegable “Interval”: intervalos grandes muestran resúmenes más agregados de la actividad, ideales para ver tendencias, mientras que los intervalos más cortos permiten hacer zoom en detalles concretos durante una ventana temporal específica. Ten en cuenta que el gráfico no se actualiza en tiempo real, por lo que si necesitas los datos más recientes tendrás que recargar la página.
Un detalle muy útil es que las opciones de periodo e intervalo se reflejan automáticamente en la URL. Si compartes ese enlace con otra persona de la organización, verá exactamente la misma vista, con el mismo rango temporal y el mismo nivel de detalle, lo cual simplifica mucho el trabajo colaborativo al analizar incidentes o picos de uso.
Roles personalizados y permiso para ver insights de API
GitHub permite que no solo los propietarios de la organización accedan a estos datos. Puedes crear roles de organización personalizados para delegar el acceso a las conclusiones de la API sin dar permisos de administración excesivos. Esto es especialmente útil para equipos de observabilidad, seguridad en GitHub, finops o plataformas internas.
Al definir un rol personalizado, tienes que incluir el permiso específico “View organization API insights”. Una vez creado el rol con ese permiso, puedes asignarlo a miembros individuales o a equipos completos de la organización. Así, por ejemplo, tu equipo de DevOps puede monitorizar el consumo de API de integraciones internas sin necesidad de ser propietario de la organización.
Uso de la tabla «Actors» para analizar aplicaciones y usuarios
Dentro de los informes de API, una pieza clave es la tabla «Actors», que lista todas las GitHub Apps y usuarios que han realizado solicitudes REST en la organización durante el periodo seleccionado. Aunque esta tabla tampoco se actualiza automáticamente, ofrece una vista muy clara de quién está consumiendo el límite de volumen principal.
Para sacarle partido, primero accedes a los insights de API siguiendo los pasos descritos antes, y después utilizas los filtros disponibles sobre la tabla. Puedes filtrar por nombre introduciendo las primeras letras en el cuadro de búsqueda y pulsando Enter, lo que permite localizar rápidamente una aplicación concreta o un usuario sospechoso.
También dispones de filtros por tipo de actor y por tipo de solicitud: el desplegable «Type» te deja elegir entre aplicaciones y usuarios, mientras que el desplegable «Requests» te permite centrarte en todas las peticiones o únicamente en aquellas que hayan estado afectadas por los límites de tasa principales. Esto último viene muy bien cuando quieres detectar qué consumidor concreto está provocando throttling.
Si haces clic en una aplicación de la tabla «Actors», pasas a una vista específica para esa GitHub App, donde se muestra su actividad de API REST, los endpoints accedidos y cualquier situación en la que haya alcanzado el límite de tasa principal. De esta forma puedes identificar, por ejemplo, qué integración está sobredimensionada o qué automatización necesita caching o batching.
Del mismo modo, si seleccionas un usuario concreto, accedes a una vista centrada en la actividad de sus personal access tokens y de las OAuth apps que actúan en su nombre. Ambos tipos de credenciales consumen el límite de volumen principal personal de ese usuario. Desde ahí puedes incluso abrir el detalle de un token personal o de una OAuth app para ver su actividad concreta y revisar si hay comportamientos anómalos.
Insights y analítica en GitHub Projects
Más allá de la API, GitHub ofrece herramientas de análisis para Projects que permiten crear y personalizar gráficos a partir de los elementos que tengas en tu proyecto (issues, pull requests, tareas, etc.). Estos gráficos son compartidos: cualquier persona con acceso al proyecto puede verlos.
Al configurar un gráfico decides los filtros, el tipo de visualización y qué campo quieres mostrar como métrica. Puedes generar dos grandes familias de gráficos: actuales e históricos, cada una con un propósito diferente pero complementario para la gestión de proyectos.
Gráficos actuales de Projects
Los gráficos actuales están pensados para visualizar el estado presente de los elementos del proyecto. Por ejemplo, puedes montar un gráfico que muestre cuántos elementos están asignados a cada persona del equipo o cuántas incidencias hay asociadas a cada iteración futura, ideal para ver la carga de trabajo distribuida.
Estos gráficos se alimentan de filtros muy flexibles. Puedes limitar la vista a determinadas etiquetas, responsables o tipos de elemento para centrar el gráfico en un subconjunto relevante, como solo bugs críticos o únicamente tareas de una determinada área del producto. Esto te permite, por ejemplo, construir fácilmente una vista de “trabajo pendiente” filtrada por un equipo concreto.
Es importante tener presente que Insights no tiene en cuenta los elementos archivados o eliminados. Los gráficos actuales solo trabajan con los elementos activos en el proyecto, así que si has archivado tareas antiguas no aparecerán reflejadas, lo cual ayuda a mantener las vistas limpias y consistentes.
Para profundizar en estas vistas puedes apoyarte en las opciones adicionales de creación y configuración de gráficos en Projects, donde se detalla cómo combinar filtros, elegir campos de agregación y definir el tipo de gráfico más adecuado (barras, líneas, etc.) para cada caso.
Gráficos históricos de Projects
Los gráficos históricos, por su parte, se centran en la evolución de los elementos a lo largo del tiempo. Son especialmente útiles para ver tendencias, ritmos de cierre y comportamiento del flujo de trabajo en iteraciones largas o proyectos complejos.
Este tipo de gráficos hacen seguimiento de cambios en el estado de los elementos del proyecto. Puedes ver elementos «Abiertos» (issues y pull requests que siguen activos), «Completados» (issues cerradas como resultado de pull requests completadas o fusionadas), «Pull requests cerradas» y elementos «No planificados» (incidencias cerradas con ese estado), con la posibilidad de visualizar el número de elementos o una agregación de su peso a lo largo del tiempo.
El gráfico histórico más típico es el de “Trabajos terminados”, que muestra cuánta carga se ha completado y cuánto trabajo queda. Esta vista ayuda a detectar si el ritmo de cierre está cayendo, si te estás dejando tareas atascadas en ciertas etapas o si hay cuellos de botella recurrentes en un tipo de trabajo concreto.
Para crear un gráfico histórico basta con configurar el eje X en “Tiempo” y aplicar los filtros que necesites. De nuevo, los mismos filtros de Projects te permiten limitar la serie temporal a determinados equipos, etiquetas o status. GitHub ofrece documentación específica adicional para sacar todo el partido a la creación y configuración avanzada de estos gráficos.
Insights de debates y comunidad
Si tu organización utiliza GitHub Discussions, la sección de perspectivas de debates es clave para medir el pulso de la comunidad. Desde aquí puedes analizar contribuciones, visualizaciones de página y crecimiento de usuarios activos en los debates, tanto a nivel de repositorio como a nivel de debates de organización.
Una de las métricas destacadas es la actividad de contribución en debates, propuestas y pull requests, donde ves el número total de interacciones. Esto ayuda a entender si los debates se usan realmente como canal de colaboración o si están quedando en segundo plano frente a issues o canales externos.
También dispones de datos de vistas de página de debates, segmentadas por usuarios autenticados y visitantes anónimos. Esta diferenciación es muy útil para saber cuánto tráfico llega desde fuera de tu base de usuarios interna y hasta qué punto tu repositorio y sus discusiones están atrayendo a la comunidad abierta.
Las métricas de contribuyentes diarios muestran el número de usuarios únicos que reaccionan, votan, marcan respuestas, comentan o publican en el periodo elegido. Por otro lado, las métricas de contribuyentes nuevos se centran en las personas que participan por primera vez, lo que permite ver si realmente estás sumando gente nueva o solo interactúan los de siempre.
Para llegar a estas vistas, navegas al repositorio correspondiente, entras en «Insights» y luego en la sección «Community» de la barra lateral izquierda. Desde la parte superior derecha puedes seleccionar el periodo a analizar (30 días, 3 meses o 1 año), lo que te permite comparar el comportamiento en ventanas cortas o en horizontes más largos.
Plataforma de facturación: uso, costes e informes CSV
Otro bloque fundamental de insights de GitHub son los relativos a facturación. La plataforma de billing te permite analizar tendencias de uso, buscar y filtrar por repositorio o producto y generar informes de distintos periodos: hora actual, día, mes en curso, mes anterior, año actual, año anterior o rangos personalizados.
Para cuentas personales, puedes ver el uso y descargar los datos en CSV para analizarlos fuera de GitHub. El recorrido es siempre similar: foto de perfil, «Settings», sección «Billing and licenses» y pestaña «Usage». Desde ahí, la barra de búsqueda y los menús desplegables te permiten filtrar el gráfico por grupo, producto, SKU o periodo de tiempo.
Si seleccionas un periodo como «Mes actual» y dejas el grupo sin agrupar, obtendrás una vista donde comparar presupuesto mensual y uso real acumulado al día, algo clave para no llevarte sustos a final de mes. Debajo del gráfico se muestra un desglose detallado por fecha, y al desplegar cada fila ves una tabla anidada con uso por SKU, unidades, precio por unidad y consumo real.
Desde la misma pantalla puedes pedir diferentes tipos de informe de uso en CSV. El “usage billing report” te da todo el desglose de consumo medido, mientras que el informe “Copilot premium requests usage report” se centra en las solicitudes premium de GitHub Copilot, con opciones de rangos predefinidos o intervalos personalizados de hasta 31 días.
Para organizaciones, el proceso es parecido pero se realiza desde «Your organizations». El propietario o el administrador de facturación puede revisar el uso de todos los miembros, filtrar por grupos y periodos exactamente igual que en cuentas personales, y generar los mismos tipos de informes, incluyendo un reporte específico de solicitudes Premium de Copilot de los últimos 45 días.
En la sección «Licenses» de la misma área de facturación, puedes descargar informes CSV de uso de licencias de los miembros de la organización. Con un solo clic en el icono correspondiente a la derecha del tipo de licencia obtienes el CSV para trabajarlo en tu herramienta de BI o en una hoja de cálculo y así medir adopción, inactividad o sobredimensionamiento de licencias.
Tráfico, sitios de referencia y contenido popular
La sección de tráfico de GitHub Insights te muestra de dónde vienen las visitas a tu repositorio y qué contenido está generando más interés. Es una especie de mini-analytics centrado en clones, visitas y páginas más vistas.
Desde aquí puedes ver los sitios de referencia, excluyendo motores de búsqueda y el propio GitHub, que apuntan a rutas concretas de tu repositorio. Esto te permite identificar, por ejemplo, artículos, blogs o documentación externa que enlazan tu proyecto y entender mejor por qué ciertas rutas reciben picos de tráfico.
La sección de contenido popular vincula las páginas más vistas del repositorio con el contenido específico que generó ese tráfico. Los sitios de referencia y el contenido popular se ordenan por vistas y visitantes únicos, lo que facilita priorizar qué partes de la documentación o del código merecen más mimo o actualización.
En cuanto a actualización de datos, los clones y la información de visitantes se refrescan cada hora, mientras que las secciones de sitios de referencia y contenido popular se actualizan diariamente. Todos los datos del gráfico de tráfico se muestran en UTC+0, independientemente de tu zona horaria local, algo a tener en cuenta al comparar con otras herramientas de monitorización.
Para entrar en esta sección solo tienes que ir a la página principal del repositorio, hacer clic en «Insights» y elegir «Traffic» en la barra lateral izquierda. Con unos pocos clics tienes la foto de qué partes de tu repositorio están resultando más visibles y desde dónde llegan los usuarios.
Gráficos de commits, frecuencia de código y vista de actividad
Otra fuente importante de insights dentro de GitHub son los gráficos relacionados con la evolución del código: commits, frecuencia de código y actividad detallada. Estos gráficos permiten analizar la dinámica de contribución y cambios a lo largo del tiempo.
El gráfico de commits muestra todas las confirmaciones realizadas en el repositorio durante el último año, excluyendo merges. En la parte superior se ven las confirmaciones por semana durante los 12 meses, mientras que el gráfico inferior refleja el promedio de commits por día de la semana para la semana seleccionada, lo que ayuda a detectar patrones y hábitos de trabajo del equipo.
El gráfico de frecuencia de código se centra en las adiciones y eliminaciones de contenido semana a semana en el historial de un repositorio. Esta métrica ayuda a visualizar períodos de actividad intensa (grandes refactors, migraciones, nuevas funcionalidades) frente a épocas más estables con menos cambios estructurales.
Desde la propia pantalla del gráfico de frecuencia de código puedes cambiar la vista a tabla, lo que facilita comparar semanas concretas y exportar los datos. Además, hay opciones para descargar los datos en CSV o la visualización en PNG, ideal si quieres incluir estos gráficos en informes internos o presentaciones sin tener que hacer capturas manuales.
Si tu necesidad es ver un historial todavía más granular, la vista de actividad del repositorio muestra todas las inserciones, merges, pushes forzados y cambios de rama, y los asocia con las confirmaciones y los usuarios autenticados responsables. Es una herramienta muy útil para auditoría, revisión de cambios delicados o análisis post‑mortem tras incidentes.
Métricas de GitHub Actions: uso y rendimiento
Para organizaciones que utilizan de forma intensiva los flujos de trabajo automatizados, las métricas de GitHub Actions ofrecen una visión muy completa de coste y eficiencia, tanto a nivel de organización como de repositorio. GitHub diferencia claramente entre métricas de uso y métricas de rendimiento.
Métricas de uso de GitHub Actions
Las métricas de uso se centran en cómo está consumiendo tu organización los minutos de acciones. Con ellas puedes visualizar datos de uso por flujo de trabajo, por job, por repositorio, por sistema operativo del runner y por tipo de ejecutor (self‑hosted vs GitHub‑hosted).
Por ejemplo, puedes ver qué flujos de trabajo consumen más minutos y plantearte refactorizarlos, dividirlos o cambiar a un ejecutor más grande para que terminen antes. También puedes analizar qué jobs son los más pesados, en qué repositorios se dispara el uso o qué sistemas operativos están asumiendo la mayor carga.
Otro punto interesante es la comparación por tipo de ejecutor: puedes medir cómo se reparten los minutos entre runners autohospedados y runners hospedados por GitHub, y ver no solo el consumo, sino el volumen de ejecuciones para cada tipo. Esto, unido a la analítica de facturación, te ayuda a decidir si te conviene mover cargas a self‑hosted para ahorrar o al revés.
Es importante saber que estas métricas de uso no aplican multiplicadores de minutos sobre los datos mostrados. Servirán para entender en qué se gastan los minutos, pero no representan necesariamente el coste final facturado. Para temas de precios concretos, tienes que revisar la documentación de facturación de GitHub Actions.
Métricas de rendimiento de GitHub Actions
Las métricas de rendimiento se orientan a evaluar la eficiencia y fiabilidad de tus flujos de trabajo. Aquí lo importante son indicadores como el tiempo medio de ejecución de los jobs, el tiempo medio de cola y la tasa de errores, todo ello con la posibilidad de filtrar por flujos de trabajo, jobs, repositorios, sistema operativo de ejecución y tipo de ejecutor.
En la vista por flujos de trabajo puedes ver tiempos medios y número de errores por workflow, identificando cuáles son ineficientes o demasiado frágiles. En la vista por jobs, obtienes el detalle a nivel de tarea individual, perfecto para localizar test suites lentas, pasos con dependencias problemáticas o jobs que pasan demasiado tiempo esperando recursos.
La perspectiva por repositorio ofrece un resumen de las métricas de rendimiento promedio para cada repo de la organización, mientras que las vistas por sistema operativo de ejecución y tipo de runner te ayudan a comprender qué entorno se comporta mejor en términos de tiempos y estabilidad.
La selección de periodo de tiempo disponible para estas métricas permite consultar ventanas predefinidas, siempre expresadas en días UTC. Además, se excluyen automáticamente las ejecuciones omitidas o aquellas que no consumen minutos, para que las métricas no se distorsionen con jobs que realmente no han llegado a ejecutarse.
Para acceder a estas métricas, entras en tu organización desde la foto de perfil, vas a «Insights» y allí eliges «Actions Usage Metrics» o «Actions Performance Metrics» según lo que quieras analizar. Desde esa vista puedes cambiar el periodo, moverte entre pestañas de métricas y aplicar filtros avanzados con el botón «Filter», agregando condiciones sobre diferentes campos y combinándolas según tus necesidades.
En el caso específico de las métricas de uso, tienes además la opción de descargar los datos como archivo CSV, lo que resulta ideal si quieres integrarlos en informes corporativos, dashboards de observabilidad o análisis más complejos con herramientas externas.
Todo este ecosistema de informes e insights de GitHub compone una capa de observabilidad muy potente sobre código, comunidad, automatización y costes. Aprovechando bien estas vistas —API, Projects, debates, tráfico, facturación, commits y Actions— es posible pasar de gestionar GitHub “a ciegas” a hacerlo con datos precisos, alineando la evolución técnica con las necesidades del negocio y asegurando que cada minuto y cada recurso estén realmente bien invertidos.
