Git Analytics — Guide utilisateur

À quoi sert le module « Git Analytics »

Le module collecte et visualise des analyses sur vos projets GitLab — pipelines, merge requests, commits et métriques d'équipe — sans avoir à ouvrir l'interface web GitLab. Toutes les données se synchronisent dans une base locale selon un planning, vous pouvez donc travailler hors ligne et voir une vue unifiée de plusieurs projets/équipes sur un seul écran.

Uniquement GitLab (cloud gitlab.com et auto-hébergé). GitHub est réservé comme type de fournisseur dans le code, mais l'adaptateur n'est pas encore implémenté.

Ce que vous obtenez :

Vue CI/CD unifiée — chaque pipeline des projets sélectionnés dans un tableau avec filtres par statut et recherche par branche.
Métriques de revue de code — Lead Time, Cycle Time et durée de vie moyenne des MR ; taux de réussite des pipelines.
Statistiques par développeur — commits, ajouts/suppressions, nombre de MR et commentaires par contributeur + métriques dérivées (velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance).
Revue IA des nouveaux MR — relecteurs IA configurables avec leur propre prompt et fournisseur IA, exécutés automatiquement ou à la demande, avec résultats sauvegardés près du MR.
Cache local — les données vivent dans la base chiffrée de YoBench, disponibles pour filtrage et analyse hors réseau.

Paramètres de connexion d'un projet

À l'ajout d'un nouveau projet, vous spécifiez :

Type de fournisseur — gitlab (actuellement seule option fonctionnelle).
Nom d'affichage — comment le projet apparaît dans les filtres et tableaux.
Base URL — URL de l'API : https://gitlab.com pour le cloud ou votre URL auto-hébergée.
Chemin du projet — par exemple group/subgroup/project.
Token privé — token pour l'API GitLab. Nécessite l'accès en lecture au dépôt, aux MR et aux pipelines.
URL Git — URL de clone (HTTPS ou SSH) ; utilisée pour un traitement local partiel (lecture des diffs).
Clé SSH (optionnel) — si l'URL Git est SSH.
Activé — drapeau d'activité pour la synchronisation.
Auto-revue des nouveaux MR — quand activé, les nouveaux MR déclenchent automatiquement les relecteurs IA assignés.

Réglages globaux du module

Configurés dans Réglages → Git Analytics :

Activer Git Analytics (gitAnalyticsEnabled) — interrupteur principal du planificateur. Désactivé par défaut — tant qu'il n'est pas activé, les projets ne sont pas synchronisés automatiquement.
Intervalle de synchronisation (minutes) (gitAnalyticsPollMinutes) — fréquence d'interrogation de l'API. Par défaut 60 minutes.

Tout le reste — tokens, relecteurs IA, auto-revue — est configuré par projet ou par relecteur.

Relecteurs IA

La revue IA est construite autour d'une entité « relecteur ». Chaque relecteur a :

Nom — affiché dans le menu déroulant Revue près d'un MR.
Fournisseur IA — quel fournisseur du registre AI Chat utiliser.
Prompt — instructions pour analyser le diff (style de revue, points d'attention, format de sortie).

Les relecteurs sont rattachés aux projets dans les réglages. Avec Auto-revue activé, à la première synchronisation d'un nouveau MR :

Le module récupère le diff via l'API GitLab.
Les métadonnées du MR + le diff sont envoyés aux relecteurs assignés successivement.
Chaque résultat de revue est sauvegardé en base et visible dans le panneau Revue près du MR.

Vous pouvez aussi déclencher une revue manuellement pour n'importe quel MR — le bouton Revue ouvre un panneau avec sélection du relecteur et résultat.

Capacités de l'UI

L'écran principal a quatre sous-onglets Analytics.

Pipelines

Tableau des pipelines des projets sélectionnés sur la période.

Colonnes : ID, branche, statut (success / failed / running / canceled), source (push / merge / api), date de création, durée.

Résumé en haut : total pipelines, réussis, échoués, taux de réussite, durée moyenne.

Filtres : par statut, recherche par branche. Cliquer sur une ligne ouvre un panneau avec les jobs et la trace.

Merge Requests

Tableau des MR avec métriques de cycle de vie.

Colonnes : #, titre, auteur, branche, état, date de création, date de merge, Lead Time, Cycle Time, nombre de commentaires.

Résumé : MR créés, mergés, durée de vie moyenne, merge rate.

Filtres : par état (opened / merged / closed), recherche par titre ou branche. Le bouton Revue lance ou affiche la revue IA d'un MR spécifique.

Project Stats

Métriques du projet sélectionné sur la période : commits, ajouts/suppressions, nombre de MR, pipelines, branches, contributeurs. Graphique d'activité par jour.

People Stats

Tableau par contributeur : commits, ajouts, suppressions, MR créés, MR mergés, commentaires. Tri par n'importe quelle colonne. Métriques étendues : velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance.

Filtres période et projets

Barre d'outils en haut de la page :

Période — semaine / mois / trimestre / année / tout. Par défaut : mois.
Sélecteur de projets — un ou plusieurs ; vide signifie « tous les projets activés ».

Flux d'utilisation

1. Ajoutez un projet

Ouvrez le module Git Analytics depuis le menu de gauche.
Basculez vers l'onglet Réglages.
Cliquez sur Ajouter un projet.
Renseignez Base URL, Chemin, Token, Nom d'affichage, URL Git.
Optionnellement activez Auto-revue des nouveaux MR.
Enregistrez.

2. Activez la synchronisation automatique

Dans Réglages → Git Analytics, activez l'interrupteur principal et définissez l'intervalle en minutes. Sans cela, les projets ne se rafraîchissent que sur clic Synchroniser.

3. Synchronisez les données

Un bouton Synchroniser en haut de la page interroge tous les projets activés : tire pipelines, MR, commits et branches. La progression est visible dans Logs.

4. Explorez les analyses

Basculez entre les sous-onglets Pipelines / Merge Requests / Project Stats / People Stats. Appliquez les filtres période et projets.

5. Configurez les revues IA

Créez un relecteur IA : nom, fournisseur IA, prompt.
Rattachez le relecteur à un projet.
Activez Auto-revue des nouveaux MR — les futurs MR seront analysés automatiquement.
Pour les MR existants, utilisez le bouton Revue dans la liste.

Étapes suivantes

Configurez les fournisseurs IA — sans eux, la revue IA ne fait rien.
Utilisez le Tracker pour gérer les tâches en parallèle de l'analytique de code.
Les grandes équipes peuvent ajouter Health Check pour le monitoring séparé des instances GitLab.

Aide et retour

Bug ou demande d'un adaptateur GitHub/Bitbucket ? Contactez-nous via le formulaire de retour.