Git Analytics — руководство пользователя

Что такое модуль «Git Analytics»

Модуль собирает и показывает аналитику по вашим GitLab-проектам — пайплайны, мерж-реквесты, коммиты и метрики команды — без необходимости открывать веб-интерфейс GitLab. Все данные синхронизируются по расписанию в локальную базу, поэтому работа возможна и оффлайн, а сводный взгляд по нескольким проектам/командам доступен в одном экране.

Поддерживается только GitLab (cloud gitlab.com и self-hosted). Подключение к GitHub в коде зарезервировано как тип, но адаптер ещё не реализован.

Что вы получаете:

Сводный взгляд на CI/CD — все пайплайны выбранных проектов в одной таблице с фильтрами по статусу и поиску по ветке.
Метрики код-ревью — Lead Time, Cycle Time и среднее время жизни MR; процент успешных пайплайнов.
Статистика по разработчикам — коммиты, инсёрты/делиты, число MR и комментариев на каждого участника + производные метрики (velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance).
AI-ревью новых MR — настраиваемые AI-рецензенты с собственным промптом и AI-провайдером запускаются автоматически или вручную и сохраняют результат рядом с MR.
Локальный кеш — данные хранятся в зашифрованной БД YoBench, доступны для фильтрации и анализа без сети.

Параметры подключения проекта

При добавлении нового проекта указываете:

Тип провайдера — gitlab (на текущий момент единственный рабочий вариант).
Имя для отображения — как проект будет показан в фильтрах и таблицах.
Base URL — адрес API: https://gitlab.com для cloud или ваш self-hosted URL.
Path проекта — например group/subgroup/project.
Private token — токен для GitLab API. Нужны разрешения на чтение репозитория, MR-ов и пайплайнов.
Git URL — адрес для клонирования (HTTPS или SSH), используется для частичной локальной обработки (например, чтения diff'ов).
SSH-ключ (опционально) — если Git URL — SSH.
Включён — флаг активности проекта в синхронизации.
Авто-ревью новых MR — если включено, при появлении нового MR автоматически запускаются назначенные AI-рецензенты (если они настроены).

Глобальные настройки модуля

Настраиваются в Настройки → Git Analytics:

Включить Git-аналитику (gitAnalyticsEnabled) — главный выключатель планировщика. По умолчанию выключен, до включения проекты не синхронизируются автоматически.
Интервал синхронизации (минуты) (gitAnalyticsPollMinutes) — как часто планировщик опрашивает API. По умолчанию 60 минут.

Прочее — токены, AI-рецензенты, авто-ревью — настраивается на уровне проекта или AI-рецензента.

AI-рецензенты

AI-ревью построено на сущности «рецензент». Каждый рецензент — это набор:

Имя — отображается в выпадающем меню «Ревью» рядом с MR.
AI-провайдер — какой провайдер из общего реестра AI Chat использовать.
Промпт — инструкция, как анализировать diff (стиль ревью, на что обращать внимание, формат вывода).

Рецензенты привязываются к проектам в настройках. Если для проекта включено Авто-ревью, то при первой синхронизации нового MR:

Модуль скачивает diff из GitLab API.
Метаданные MR + diff отправляются назначенным рецензентам по очереди.
Результат каждого ревью сохраняется в БД и доступен в панели Ревью рядом с MR.

В UI можно вручную запустить ревью любого MR — кнопка Ревью открывает панель с выбором рецензента и выводом результата.

Возможности UI

Главный экран разделён на четыре подвкладки Аналитика:

Pipelines (Пайплайны)

Таблица пайплайнов выбранных проектов за период.

Колонки: ID, ветка, статус (success / failed / running / canceled), source (push / merge / api), время создания, длительность.

Сводка сверху: всего пайплайнов, успешные, с ошибкой, процент успеха, средняя длительность.

Фильтры: по статусу, поиск по ветке. Клик по строке открывает панель с jobs и трейсом.

Merge Requests

Таблица MR с метриками жизненного цикла.

Колонки: #, заголовок, автор, ветка, состояние, дата создания, дата мержа, Lead Time, Cycle Time, число комментариев.

Сводка: создано MR, смержено, среднее время жизни, merge rate.

Фильтры: по состоянию (opened / merged / closed), поиск по названию или ветке. Кнопка Ревью запускает или показывает AI-ревью конкретного MR.

Project Stats (Статистика проекта)

Метрики выбранного проекта за период: коммиты, добавленные/удалённые строки, количество MR, пайплайнов, веток, контрибьюторов. График активности по дням.

People Stats (Статистика людей)

Таблица контрибьюторов с метриками: коммиты, инсёрты, делиты, MR создано, MR смержено, комментарии. Сортировка по любой колонке. Расширенные метрики: velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance.

Фильтры по периоду и проектам

Тулбар сверху страницы:

Период — неделя / месяц / квартал / год / всё время. По умолчанию — месяц.
Селектор проектов — один или несколько; пустой выбор означает «все включённые проекты».

Флоу использования

1. Подключите проект

Откройте модуль Git Analytics в левом меню.
Перейдите на вкладку Настройки.
Нажмите Добавить проект.
Заполните Base URL, Path, Token, Display Name, Git URL.
При желании включите Авто-ревью новых MR.
Сохраните.

2. Включите автоматическую синхронизацию

В Настройки → Git Analytics включите главный переключатель и задайте интервал в минутах. Без этого проекты обновляются только по нажатию Синхронизировать.

3. Синхронизируйте данные

В шапке страницы — кнопка Синхронизировать. Запускает опрос всех включённых проектов: подтягивает пайплайны, MR-ы, коммиты, ветки. Прогресс виден в логах (кнопка Логи).

4. Изучайте аналитику

Переключайтесь между подвкладками Пайплайны / Мерж-реквесты / Статистика проекта / Статистика людей. Применяйте фильтры по периоду и проектам.

5. Настройте AI-ревью

Создайте AI-рецензента: имя, AI-провайдер, промпт.
Привяжите рецензента к проекту.
Включите Авто-ревью новых MR — будущие MR-ы будут анализироваться автоматически.
Для готовых MR используйте кнопку Ревью в списке.

Что дальше

Настройте AI-провайдеров — без них AI-ревью не работает.
Используйте Tracker для управления задачами параллельно с аналитикой по коду.
Большие команды могут включать Health Check для отдельного мониторинга своих GitLab-инстансов.

Помощь и обратная связь

Нашли баг или хотите попросить адаптер для GitHub/Bitbucket? Напишите нам через форму обратной связи.