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

Интеграция с Azure DevOps

Интеграция PanDev Metrics с Azure DevOps позволяет анализировать активность разработки в Azure Repos, пул-реквесты и связывать метрики с Azure Pipelines.

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

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

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

  • Azure DevOps Services (облачная версия)
  • Azure DevOps Server (On-Premise)

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

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

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

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

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

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

Добавьте сервисный аккаунт в проекты Azure DevOps с ролью Contributor или Project Administrator.

Шаг 3: Создание Personal Access Token​

  1. Войдите в сервисный аккаунт
  2. Нажмите на иконку пользователя → Personal access tokens
  3. Нажмите New Token
  4. Настройте токен:
ПараметрЗначение
Namepandev-metrics
OrganizationВыберите вашу организацию (или All accessible organizations)
ExpirationCustom (рекомендуется 1 год)
  1. В разделе Scopes выберите Custom defined и настройте права:
ScopeAccess
CodeRead
Pull Request ThreadsRead & Write
Work ItemsRead
  1. Нажмите Create и сохраните токен
Важно

Токен отображается только один раз! Сохраните его в безопасном месте.

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

  1. Перейдите в Настройки → Интеграции → Azure DevOps
  2. Введите:
    • Organization URL: https://dev.azure.com/your-organization
    • Personal Access Token: токен из шага 3
  3. Нажмите Проверить подключение
  4. После успешной проверки нажмите Активировать

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

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

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

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

FAQ​

Работает ли интеграция с Azure DevOps Server?
Да, поддерживаются как Azure DevOps Services, так и Server (On-Premise) версии.

Можно ли ограничить интеграцию определёнными проектами?
Да, на этапе выбора проектов можно выбрать только нужные.

Как связать Work Items с метриками?
При наличии scope Work Items: Read метрики автоматически связываются с задачами через номера в сообщениях коммитов и PR.