Доступно с версии 1.16.0 (EE)
Отчёт «Аналитика CI/CD» показывает количество, продолжительность и распределение по статусам завершившихся пайплайнов, созданных за выбранный период (в отдельном проекте или в проектах группы и её подгрупп).
Доступность отчёта
Отчёт проекта доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе.
Настройка проекта «Видимость пайплайнов на уровне проекта» открывает отчёт всем, кому виден сам проект: пользователям с типом «Аудитор», участникам с ролью «Гость», в публичном проекте — любому посетителю, включая не выполнившего вход, во внутреннем — любому вошедшему пользователю. При выключенной настройке отчёт остаётся доступен участникам с ролью «Наблюдатель» и выше.
Для доступа к отчёту проекта читателю нужен также доступ к пайплайнам этого проекта. Если видимость функции «CI/CD» сужена до состава участников, отчёт закрывается для всех, кто не входит в проект, — в том числе для посетителей публичного проекта. Пользователи с типом «Аудитор» сохраняют доступ независимо от этой настройки.
Если видимость функции «Аналитика» ограничена участниками проекта, отчёт закрыт для всех остальных. Пользователи с типом «Аудитор» сохраняют доступ. Если функция выключена, отчёт закрыт для всех, включая участников проекта.
Выключение функции «CI/CD» отчёт не закрывает: у проекта сохраняется уже накопленная история пайплайнов, и отчёт продолжает её отображать. При этом пункт «Аналитика CI/CD» пропадает из меню «Аналитика» — то же происходит и при пустом репозитории проекта. В обоих случаях отчёт остаётся доступен по прямой ссылке.
Отчёт группы доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе, и пользователям с типом «Аудитор».
Просмотр отчёта
Чтобы просмотреть отчёт группы:
- В верхней панели нажмите «Искать или перейти к…» и выберите группу.
- В меню группы перейдите в «Аналитика» → «Аналитика CI/CD».
Чтобы просмотреть отчёт проекта:
- В верхней панели нажмите «Искать или перейти к…» и выберите проект.
- В меню проекта перейдите в «Аналитика» → «Аналитика 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, поэтому пайплайн, созданный в один день и завершившийся на следующий, учитывается в дне создания.
Период заканчивается началом текущего дня, поэтому пайплайны, созданные сегодня, в отчёт не попадают, а на графиках нет точки за сегодня.
Перцентили графика «Продолжительность» и метрика «Медианная продолжительность» не учитывают запуски без продолжительности и запуски с нулевой продолжительностью. За день без таких запусков точки на графике нет, а за период без таких запусков вместо медианы показан прочерк.
Отчёт группы с теми же фильтрами и периодом обновляется не чаще раза в минуту, поэтому при повторном просмотре он может отставать от текущего состояния до минуты. Отчёт проекта формируется по каждому запросу.
Если отчёт строится слишком долго, вместо графиков страница показывает сообщение об этом и предлагает сузить отчётный период. Выберите меньшее значение «Диапазона дат» и откройте отчёт заново.