Git Analytics — Benutzerhandbuch

Was das Modul „Git Analytics" leistet

Das Modul sammelt und visualisiert Analytik für Ihre GitLab-Projekte — Pipelines, Merge Requests, Commits und Teammetriken — ohne dass Sie die GitLab-Web-UI öffnen müssen. Alle Daten werden zeitgesteuert in eine lokale Datenbank synchronisiert, sodass Sie offline weiterarbeiten und einen einheitlichen Blick auf mehrere Projekte/Teams in einem Bildschirm haben.

Nur GitLab (cloud gitlab.com und Self-Hosted). GitHub ist im Code als Provider-Typ reserviert, der Adapter ist aber noch nicht implementiert.

Was Sie bekommen:

Einheitliche CI/CD-Sicht — alle Pipelines der gewählten Projekte in einer Tabelle mit Filtern nach Status und Suche nach Branch.
Code-Review-Metriken — Lead Time, Cycle Time und durchschnittliche MR-Lebensdauer; Pipeline-Erfolgsquote.
Statistik pro Entwickler — Commits, Insertions/Deletions, MR-Anzahl und Kommentare pro Mitwirkendem + abgeleitete Metriken (velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance).
KI-Review neuer MRs — konfigurierbare KI-Rezensenten mit eigenem Prompt und KI-Anbieter laufen automatisch oder bei Bedarf und speichern Ergebnisse neben dem MR.
Lokaler Cache — Daten liegen in der verschlüsselten Datenbank von YoBench, verfügbar zur Filterung und Analyse ohne Netz.

Verbindungsparameter eines Projekts

Beim Anlegen geben Sie an:

Provider-Typ — gitlab (derzeit einzige funktionierende Option).
Anzeigename — wie das Projekt in Filtern und Tabellen erscheint.
Base URL — API-URL: https://gitlab.com für cloud oder Ihre Self-Hosted-URL.
Projektpfad — z. B. group/subgroup/project.
Private Token — Token für die GitLab-API. Benötigt Lesezugriff auf Repository, MRs und Pipelines.
Git URL — Klone-URL (HTTPS oder SSH); wird für teilweise lokale Verarbeitung verwendet (z. B. Lesen von Diffs).
SSH-Key (optional) — wenn die Git URL SSH ist.
Aktiviert — Aktivitäts-Flag für die Synchronisation.
Auto-Review neuer MRs — wenn an, lösen neue MRs automatisch die zugewiesenen KI-Rezensenten aus.

Globale Modul-Einstellungen

Konfiguriert unter Einstellungen → Git Analytics:

Git-Analytics aktivieren (gitAnalyticsEnabled) — Hauptschalter des Schedulers. Standardmäßig aus — bis zur Aktivierung werden Projekte nicht automatisch synchronisiert.
Synchronisationsintervall (Minuten) (gitAnalyticsPollMinutes) — wie oft der Scheduler die API abfragt. Standard 60 Minuten.

Alles andere — Tokens, KI-Rezensenten, Auto-Review — wird pro Projekt oder pro Rezensent konfiguriert.

KI-Rezensenten

Das KI-Review baut auf der Entität „Rezensent" auf. Jeder Rezensent ist:

Name — wird im Dropdown Review neben einem MR angezeigt.
KI-Anbieter — welcher Anbieter aus der AI Chat-Registrierung verwendet wird.
Prompt — Anweisung, wie der Diff zu analysieren ist (Review-Stil, Fokusbereiche, Ausgabeformat).

Rezensenten werden in den Einstellungen an Projekte gebunden. Wenn Auto-Review an ist, wird beim ersten Synchronisieren eines neuen MR:

Das Modul lädt den Diff aus der GitLab-API.
MR-Metadaten + Diff werden den zugewiesenen Rezensenten der Reihe nach gesendet.
Jedes Review-Ergebnis wird in der DB gespeichert und ist im Review-Panel neben dem MR sichtbar.

Sie können das Review auch manuell für jeden MR auslösen — die Schaltfläche Review öffnet ein Panel mit Rezensenten-Auswahl und Ergebnis.

UI-Funktionen

Der Hauptbildschirm hat vier Analytics-Untertabs.

Pipelines

Tabelle der Pipelines der gewählten Projekte über den Zeitraum.

Spalten: ID, Branch, Status (success / failed / running / canceled), Source (push / merge / api), Erstellungszeit, Dauer.

Übersicht oben: Total Pipelines, Erfolgreich, Fehlgeschlagen, Erfolgsquote, durchschnittliche Dauer.

Filter: nach Status, Suche nach Branch. Klick auf eine Zeile öffnet ein Panel mit Jobs und Trace.

Merge Requests

MR-Tabelle mit Lebenszyklus-Metriken.

Spalten: #, Titel, Autor, Branch, Status, Erstellungsdatum, Merge-Datum, Lead Time, Cycle Time, Kommentaranzahl.

Übersicht: erstellte MRs, gemergt, durchschnittliche Lebensdauer, Merge Rate.

Filter: nach Status (opened / merged / closed), Suche nach Titel oder Branch. Die Schaltfläche Review startet oder zeigt das KI-Review eines bestimmten MR.

Project Stats

Metriken für das gewählte Projekt im Zeitraum: Commits, Insertions/Deletions, MR-Anzahl, Pipelines, Branches, Mitwirkende. Tagweises Aktivitätsdiagramm.

People Stats

Mitwirkenden-Tabelle: Commits, Insertions, Deletions, erstellte MRs, gemergte MRs, Kommentare. Nach jeder Spalte sortierbar. Erweiterte Metriken: velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance.

Zeitraum- und Projektfilter

Toolbar oben auf der Seite:

Zeitraum — Woche / Monat / Quartal / Jahr / Gesamtzeit. Standard: Monat.
Projekt-Auswahl — eines oder mehrere; leer bedeutet „alle aktivierten Projekte".

Ablauf

1. Projekt hinzufügen

Öffnen Sie das Modul Git Analytics im linken Menü.
Wechseln Sie zur Registerkarte Einstellungen.
Klicken Sie auf Projekt hinzufügen.
Tragen Sie Base URL, Pfad, Token, Anzeigename, Git URL ein.
Optional aktivieren Sie Auto-Review neuer MRs.
Speichern.

2. Automatische Synchronisation einschalten

Unter Einstellungen → Git Analytics den Hauptschalter aktivieren und das Intervall in Minuten setzen. Ohne ihn werden Projekte nur per Klick auf Synchronisieren aktualisiert.

3. Daten synchronisieren

Eine Schaltfläche Synchronisieren oben auf der Seite fragt alle aktivierten Projekte ab: zieht Pipelines, MRs, Commits und Branches. Fortschritt sichtbar in Logs.

4. Analytik erkunden

Wechseln Sie zwischen den Untertabs Pipelines / Merge Requests / Project Stats / People Stats. Wenden Sie Zeitraum- und Projektfilter an.

5. KI-Reviews einrichten

Erstellen Sie einen KI-Rezensenten: Name, KI-Anbieter, Prompt.
Binden Sie den Rezensenten an ein Projekt.
Aktivieren Sie Auto-Review neuer MRs — zukünftige MRs werden automatisch geprüft.
Für vorhandene MRs verwenden Sie die Schaltfläche Review in der Liste.

Nächste Schritte

Konfigurieren Sie KI-Anbieter — ohne sie funktioniert das KI-Review nicht.
Nutzen Sie den Tracker, um Aufgaben parallel zur Code-Analytik zu verwalten.
Größere Teams können Health Check für separates Uptime-Monitoring von GitLab-Instanzen einsetzen.

Hilfe und Feedback

Bug gefunden oder einen GitHub/Bitbucket-Adapter wünschen? Schreiben Sie uns über das Feedback-Formular.