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

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

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

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

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

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

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

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

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

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

Шаг 2: Выдайте доступы сервисному аккаунту​

Дайте роль Owner или Admin сервисному аккаунту во всех организациях, репозитории которых нужно анализировать.

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

  1. Войдите в сервисный аккаунт
  2. Перейдите в Personal Access Tokens
  3. Нажмите Generate new token → Fine-grained personal access token
  4. Настройте токен:
ПараметрЗначение
Token namepandev-metrics
Expiration90 days (или без срока)
Resource ownerВаша организация
Repository accessAll repositories
  1. В разделе Permissions → Repository permissions:
PermissionAccess
IssuesRead and write
MetadataRead-only
Pull requestsRead and write
  1. В разделе Permissions → Organization permissions:
PermissionAccess
WebhooksRead and write
  1. Нажмите Generate token и сохраните токен

Создание токена GitHub

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

  1. Перейдите в Настройки → Интеграции → GitHub
  2. Вставьте скопированный токен
  3. Нажмите Проверить подключение
  4. После успешной проверки нажмите Активировать

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

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

FAQ​

Нужен ли доступ к приватным репозиториям?
Да, для анализа приватных репозиториев токен должен иметь доступ к ним.

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

Можно ли ограничить интеграцию определёнными репозиториями?
Да, при создании токена можно выбрать Only select repositories вместо All repositories.