Перейти к основному содержимому
Версия: v2 (текущая)

Интеграция с GitLab

Интеграция PanDev Metrics с GitLab позволяет анализировать активность разработки, merge-реквесты и автоматически добавлять метрики качества в код-ревью.

Возможности интеграции​

  • Автоматические комментарии к MR — добавление метрик качества кода в merge-реквесты
  • Аналитика репозиториев — анализ коммитов, веток и контрибьюторов
  • Метрики код-ревью — время ревью, количество комментариев, цикл MR
  • Приватность — данные собираются только из ваших проектов

Поддерживаемые версии​

  • GitLab.com (облачная версия)
  • GitLab Self-Managed (On-Premise)

Настройка интеграции​

Шаг 1: Создайте сервисный аккаунт​

Создайте отдельный GitLab-аккаунт, от имени которого будет собираться аналитика и генерироваться отчеты.

Зачем нужен сервисный аккаунт?

Отдельный аккаунт позволяет разграничить автоматические комментарии от личных, а также упрощает управление доступами.

Шаг 2: Выдайте доступы​

Добавьте сервисный аккаунт в группы/проекты GitLab с ролью Maintainer или Owner.

Шаг 3: Создание токена​

  1. Войдите в сервисный аккаунт
  2. Перейдите в User Settings → Access Tokens
  3. Нажмите Add new token
  4. Настройте токен:
ПараметрЗначение
Token namepandev-metrics
Expiration date90 дней (или без срока для Self-Managed)
  1. Выберите права доступа (scopes):
ScopeОписание
apiПолный доступ к API
read_repositoryЧтение репозиториев
write_repositoryЗапись в репозитории (для комментариев)
  1. Нажмите Create personal access token и сохраните токен

Шаг 4: Подключение в PanDev Metrics​

  1. Перейдите в Настройки → Интеграции → GitLab
  2. Укажите URL GitLab:
    • Для GitLab.com: https://gitlab.com
    • Для Self-Managed: URL вашего сервера (например, https://gitlab.company.local)
  3. Вставьте скопированный токен
  4. Нажмите Проверить подключение
  5. После успешной проверки нажмите Активировать

Шаг 5: Выбор проектов​

  1. Выберите группы или проекты для мониторинга
  2. Настройте фильтры веток (опционально)
  3. Сохраните настройки

Отслеживаемые метрики​

  • Коммиты — количество и частота коммитов по разработчикам
  • Merge Requests — цикл MR, время до мержа, количество ревизий
  • Code Review — время ревью, количество комментариев
  • Активность — тренды активности по проектам и контрибьюторам

FAQ​

Работает ли интеграция с GitLab Self-Managed?
Да, поддерживаются как GitLab.com, так и Self-Managed версии.

Какие права достаточны для базовой аналитики?
Для аналитики без комментариев достаточно scopeов api и read_repository.

Как часто обновляются данные?
Данные обновляются в реальном времени через вебхуки GitLab.