Git Analytics — Guía del usuario

Para qué sirve el módulo «Git Analytics»

El módulo recopila y muestra analíticas de tus proyectos GitLab — pipelines, merge requests, commits y métricas de equipo — sin necesidad de abrir la interfaz web de GitLab. Todos los datos se sincronizan a una base local según un calendario, así puedes seguir trabajando offline y ver una vista unificada de varios proyectos/equipos en una sola pantalla.

Solo GitLab (cloud gitlab.com y self-hosted). GitHub está reservado como tipo de proveedor en el código, pero el adaptador aún no está implementado.

Lo que obtienes:

Vista unificada de CI/CD — cada pipeline de los proyectos seleccionados en una tabla con filtros por estado y búsqueda por rama.
Métricas de revisión de código — Lead Time, Cycle Time y duración media de los MR; tasa de éxito de pipelines.
Estadísticas por desarrollador — commits, inserciones/eliminaciones, número de MR y comentarios por colaborador + métricas derivadas (velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance).
Revisión IA de MR nuevos — revisores IA configurables con su propio prompt y proveedor IA, ejecutados automáticamente o bajo demanda, con resultados guardados junto al MR.
Caché local — los datos viven en la base cifrada de YoBench, disponibles para filtrado y análisis sin red.

Parámetros de conexión del proyecto

Al añadir un proyecto nuevo especificas:

Tipo de proveedor — gitlab (actualmente la única opción funcional).
Nombre para mostrar — cómo aparece el proyecto en filtros y tablas.
Base URL — URL de la API: https://gitlab.com para cloud o tu URL self-hosted.
Ruta del proyecto — por ejemplo group/subgroup/project.
Token privado — token para la API de GitLab. Necesita acceso de lectura al repositorio, MRs y pipelines.
URL Git — URL de clonado (HTTPS o SSH); se usa para procesamiento local parcial (lectura de diffs).
Clave SSH (opcional) — si la URL Git es SSH.
Activado — bandera de actividad para la sincronización.
Auto-revisión de MR nuevos — cuando está activado, los MR nuevos disparan automáticamente los revisores IA asignados.

Ajustes globales del módulo

Se configuran en Ajustes → Git Analytics:

Activar Git Analytics (gitAnalyticsEnabled) — interruptor principal del planificador. Desactivado por defecto — hasta que se active, los proyectos no se sincronizan automáticamente.
Intervalo de sincronización (minutos) (gitAnalyticsPollMinutes) — con qué frecuencia el planificador consulta la API. Por defecto 60 minutos.

Lo demás — tokens, revisores IA, auto-revisión — se configura por proyecto o por revisor.

Revisores IA

La revisión IA se construye sobre la entidad «revisor». Cada revisor tiene:

Nombre — se muestra en el desplegable Revisión junto a un MR.
Proveedor IA — qué proveedor del registro AI Chat usar.
Prompt — instrucciones para analizar el diff (estilo de revisión, áreas de foco, formato de salida).

Los revisores se vinculan a proyectos en los ajustes. Con Auto-revisión activada, en la primera sincronización de un MR nuevo:

El módulo descarga el diff desde la API de GitLab.
Metadatos del MR + diff se envían a los revisores asignados por turnos.
Cada resultado de revisión se guarda en la base y se ve en el panel Revisión junto al MR.

También puedes lanzar una revisión manualmente para cualquier MR — el botón Revisión abre un panel con selector de revisor y resultado.

Capacidades de la UI

La pantalla principal tiene cuatro sub-pestañas Analíticas.

Pipelines

Tabla de pipelines de los proyectos seleccionados durante el período.

Columnas: ID, rama, estado (success / failed / running / canceled), source (push / merge / api), fecha de creación, duración.

Resumen arriba: total de pipelines, exitosos, fallidos, tasa de éxito, duración media.

Filtros: por estado, búsqueda por rama. Hacer clic en una fila abre un panel con jobs y traza.

Merge Requests

Tabla de MR con métricas de ciclo de vida.

Columnas: #, título, autor, rama, estado, fecha de creación, fecha de merge, Lead Time, Cycle Time, número de comentarios.

Resumen: MR creados, mergeados, duración media, merge rate.

Filtros: por estado (opened / merged / closed), búsqueda por título o rama. El botón Revisión ejecuta o muestra la revisión IA de un MR específico.

Project Stats

Métricas del proyecto seleccionado durante el período: commits, inserciones/eliminaciones, número de MR, pipelines, ramas, colaboradores. Gráfico de actividad por día.

People Stats

Tabla por colaborador: commits, inserciones, eliminaciones, MR creados, MR mergeados, comentarios. Ordenable por cualquier columna. Métricas extendidas: velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance.

Filtros de período y proyectos

Barra de herramientas en la parte superior:

Período — semana / mes / trimestre / año / todo. Por defecto: mes.
Selector de proyectos — uno o varios; vacío significa «todos los proyectos activados».

Flujo de uso

1. Añade un proyecto

Abre el módulo Git Analytics en el menú lateral izquierdo.
Cambia a la pestaña Ajustes.
Pulsa Añadir proyecto.
Rellena Base URL, Ruta, Token, Nombre, URL Git.
Opcionalmente activa Auto-revisión de MR nuevos.
Guarda.

2. Activa la sincronización automática

En Ajustes → Git Analytics activa el interruptor principal y define el intervalo en minutos. Sin él, los proyectos solo se actualizan al pulsar Sincronizar.

3. Sincroniza los datos

Un botón Sincronizar en la cabecera consulta todos los proyectos activados: tira pipelines, MR, commits y ramas. El progreso se ve en Logs.

4. Explora las analíticas

Cambia entre las sub-pestañas Pipelines / Merge Requests / Project Stats / People Stats. Aplica filtros de período y proyectos.

5. Configura las revisiones IA

Crea un revisor IA: nombre, proveedor IA, prompt.
Vincula el revisor a un proyecto.
Activa Auto-revisión de MR nuevos — los MR futuros serán analizados automáticamente.
Para los MR existentes, usa el botón Revisión en la lista.

Siguientes pasos

Configura los proveedores de IA — sin ellos la revisión IA no funciona.
Usa el Tracker para gestionar tareas en paralelo a la analítica de código.
Los equipos grandes pueden añadir Health Check para monitoreo separado de uptime de las instancias de GitLab.

Ayuda y comentarios

¿Encontraste un bug o quieres pedir un adaptador para GitHub/Bitbucket? Escríbenos a través del formulario de contacto.