Доступно с версии 1.16.0 (EE)

Отчёт «Аналитика CI/CD» показывает количество, продолжительность и распределение по статусам завершившихся пайплайнов, созданных за выбранный период (в отдельном проекте или в проектах группы и её подгрупп).

Доступность отчёта

Отчёт проекта доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе.

Настройка проекта «Видимость пайплайнов на уровне проекта» открывает отчёт всем, кому виден сам проект: пользователям с типом «Аудитор», участникам с ролью «Гость», в публичном проекте — любому посетителю, включая не выполнившего вход, во внутреннем — любому вошедшему пользователю. При выключенной настройке отчёт остаётся доступен участникам с ролью «Наблюдатель» и выше.

Для доступа к отчёту проекта читателю нужен также доступ к пайплайнам этого проекта. Если видимость функции «CI/CD» сужена до состава участников, отчёт закрывается для всех, кто не входит в проект, — в том числе для посетителей публичного проекта. Пользователи с типом «Аудитор» сохраняют доступ независимо от этой настройки.

Если видимость функции «Аналитика» ограничена участниками проекта, отчёт закрыт для всех остальных. Пользователи с типом «Аудитор» сохраняют доступ. Если функция выключена, отчёт закрыт для всех, включая участников проекта.

Выключение функции «CI/CD» отчёт не закрывает: у проекта сохраняется уже накопленная история пайплайнов, и отчёт продолжает её отображать. При этом пункт «Аналитика CI/CD» пропадает из меню «Аналитика» — то же происходит и при пустом репозитории проекта. В обоих случаях отчёт остаётся доступен по прямой ссылке.

Отчёт группы доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе, и пользователям с типом «Аудитор».

Просмотр отчёта

Чтобы просмотреть отчёт группы:

  1. В верхней панели нажмите «Искать или перейти к…» и выберите группу.
  2. В меню группы перейдите в «Аналитика» → «Аналитика CI/CD».

Чтобы просмотреть отчёт проекта:

  1. В верхней панели нажмите «Искать или перейти к…» и выберите проект.
  2. В меню проекта перейдите в «Аналитика» → «Аналитика CI/CD».

Также отчёт можно открыть по прямому адресу:

ОтчётАдрес
Группаhttps://<HOST>/groups/<GROUP_PATH>/-/analytics/ci_cd_analytics
Проектhttps://<HOST>/<PROJECT_PATH>/-/analytics/ci_cd_analytics

Вместо <GROUP_PATH> укажите полный путь группы, включая родительские группы (например, team/backend). Вместо <PROJECT_PATH> укажите полный путь проекта, включая группы и подгруппы, или имя пользователя для личного проекта (например, team/backend/app или username/app).

Отчёт группы охватывает пайплайны её проектов и проектов её подгрупп, включая архивные проекты.

Метрики

В строке над графиками показаны итоги периода:

МетрикаСодержимое
«Общее количество запусков пайплайнов»Число завершившихся пайплайнов, созданных в периоде
«Медианная продолжительность»Медиана (p50) продолжительности запусков, длившихся больше нуля секунд
«Доля сбоев»Доля неуспешных запусков среди тех, что завершились успехом или неудачей
«Доля успехов»Доля успешных запусков среди тех, что завершились успехом или неудачей
«Доля остальных»Доля отменённых и пропущенных запусков среди всех запусков периода

«Доля сбоев» и «Доля успехов» считаются от запусков, завершившихся успехом или неудачей. Каждая из них округляется до целого отдельно, поэтому в сумме они дают около 100 %: при 5 успешных и 3 неуспешных запусках доля сбоев равна 38 %, а доля успехов 63 %. «Доля остальных» считается от всех запусков периода, поэтому сумма трёх показателей может превышать 100 %. Формула расчёта показана в подсказке значка «Как это рассчитывается?» рядом с «Долей сбоев» и «Долей остальных».

Доля, для знаменателя которой в периоде нет ни одного запуска, показана прочерком. Например, если в периоде есть только отменённые и пропущенные запуски, в «Доле сбоев» и «Доле успехов» показан прочерк, а в «Доле остальных» 100 %.

Когда в проекте есть неуспешные запуски, ссылка «Посмотреть все» под «Долей сбоев» открывает список пайплайнов проекта, отфильтрованный по неуспешным запускам. Выбранная в отчёте ветка переносится в этот список фильтром; со значением «Все ветки» список открывается без фильтра по ветке.

Графики

График «Продолжительность» содержит по линии на каждый перцентиль продолжительности пайплайна:

  • «Медиана (50-й процентиль)»;
  • «95-й перцентиль».

Вертикальная ось графика размечена в минутах.

График «Статус» содержит по столбцу на каждый день, разделённому на серии:

  • «Успешные»;
  • «Ошибка»;
  • «Другие (отменённые, пропущенные)».

По вертикальной оси графика — количество пайплайнов.

Фильтры

Фильтры над графиками ограничивают метрики и оба графика:

ФильтрЗначения
«Источник»Событие, создавшее пайплайн: «Push», «Расписание», «Событие запроса на слияние» и остальные. По умолчанию — «Любой источник»
«Ветвь»Ветка пайплайна. Изначально выбрана ветка по умолчанию проекта, а значение «Все ветки» снимает фильтр. В отчёте группы такого фильтра нет
«Диапазон дат»«Прошлая неделя», «Последние 30 дней», «Последние 90 дней», «Последние 180 дней». По умолчанию — «Прошлая неделя»

Фильтр «Ветвь» также учитывает пайплайны запросов на слияние, для которых выбранная ветка является исходной. Такие пайплайны попадают в отчёт, если для фильтра «Источник» выбрано «Любой источник» или «Событие запроса на слияние». При выборе другого источника отчёт учитывает только пайплайны самой ветки.

Выбранные фильтры сохраняются в адресе страницы в параметрах source и time, поэтому настроенный отчёт можно передать ссылкой. В отчёте проекта туда же попадает ветка, в параметре branch.

Как считаются пайплайны

Отчёт учитывает пайплайны, созданные в периоде и дошедшие до завершённого статуса: успешные, неуспешные, отменённые и пропущенные. Пайплайн относится к дню своего создания, отсчитанному по UTC, поэтому пайплайн, созданный в один день и завершившийся на следующий, учитывается в дне создания.

Период заканчивается началом текущего дня, поэтому пайплайны, созданные сегодня, в отчёт не попадают, а на графиках нет точки за сегодня.

Перцентили графика «Продолжительность» и метрика «Медианная продолжительность» не учитывают запуски без продолжительности и запуски с нулевой продолжительностью. За день без таких запусков точки на графике нет, а за период без таких запусков вместо медианы показан прочерк.

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

Если отчёт строится слишком долго, вместо графиков страница показывает сообщение об этом и предлагает сузить отчётный период. Выберите меньшее значение «Диапазона дат» и откройте отчёт заново.