Отчёт «Аналитика CI/CD» показывает, сколько пайплайнов, созданных группой или проектом за выбранный период, завершилось, сколько они выполнялись и как распределились их статусы.
Доступность отчёта
Отчёт проекта доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе.
Настройка проекта «Видимость пайплайнов на уровне проекта» открывает отчёт всем, кому виден сам проект: пользователям с типом «Аудитор», участникам с ролью «Гость», в публичном проекте — любому посетителю, включая не выполнившего вход, во внутреннем — любому вошедшему пользователю. При выключенной настройке отчёт остаётся доступен участникам с ролью «Наблюдатель» и выше.
Для доступа к отчёту проекта читателю нужен также доступ к пайплайнам этого проекта. Если видимость функции «CI/CD» сужена до состава участников, отчёт закрывается для всех, кто не входит в проект, — в том числе для посетителей публичного проекта. Пользователи с типом «Аудитор» сохраняют доступ независимо от этой настройки.
Сужение видимости функции «Аналитика» до состава участников закрывает отчёт так же, и пользователи с типом «Аудитор» так же его сохраняют. Выключение функции «Аналитика» закрывает отчёт для всех, включая участников проекта.
Выключение функции «CI/CD» отчёт не закрывает: у проекта сохраняется уже накопленная история пайплайнов, и отчёт продолжает её отображать. При этом пункт «Аналитика CI/CD» пропадает из меню «Аналитика» — то же происходит и при пустом репозитории проекта. В обоих случаях отчёт остаётся доступен по прямой ссылке.
Отчёт группы доступен участникам с ролью «Наблюдатель» и выше, в том числе тем, кто получил роль в родительской группе, и пользователям с типом «Аудитор».
Просмотр отчёта
Чтобы просмотреть отчёт группы:
- В верхней панели нажмите «Искать или перейти к…» и выберите группу.
- В меню группы перейдите в «Аналитика» → «Аналитика CI/CD».
Чтобы просмотреть отчёт проекта:
- В верхней панели нажмите «Искать или перейти к…» и выберите проект.
- В меню проекта перейдите в «Аналитика» → «Аналитика CI/CD».
Также отчёт можно открыть по прямому адресу:
| Отчёт | Адрес |
|---|---|
| Группа | https://<HOST>/groups/<GROUP>/-/analytics/ci_cd_analytics |
| Проект | https://<HOST>/<GROUP>/<PROJECT>/-/analytics/ci_cd_analytics |
Отчёт группы охватывает пайплайны её проектов и проектов её подгрупп, включая архивные проекты.
Метрики
Строка над графиками подводит итог периода:
| Метрика | Содержимое |
|---|---|
| «Общее количество запусков пайплайнов» | Число завершившихся пайплайнов, созданных в периоде |
| «Медианная продолжительность» | Медианная продолжительность (p50) запусков, которые выполнялись |
| «Доля сбоев» | Доля неуспешных запусков среди тех, что завершились успехом или неудачей |
| «Доля успехов» | Доля успешных запусков среди тех, что завершились успехом или неудачей |
| «Доля остальных» | Доля отменённых и пропущенных запусков среди всех запусков периода |
«Доля сбоев» и «Доля успехов» считаются от запусков, завершившихся успехом или неудачей. Каждая из них округляется до целого отдельно, поэтому в сумме они дают около ста: период с 5 успешными и 3 неуспешными запусками показывает долю сбоев 38 % и долю успехов 63 %. «Доля остальных» считается от всех запусков периода и добавляется к ним сверху. Значок «Как это рассчитывается?» рядом с «Долей сбоев» и «Долей остальных» приводит формулу.
Доля, для знаменателя которой в периоде нет ни одного запуска, показана прочерком. Поэтому период с одними отменёнными и пропущенными запусками даёт прочерк в «Доле сбоев» и «Доле успехов» и сто процентов в «Доле остальных».
Когда в проекте есть неуспешные запуски, ссылка «Посмотреть все» под «Долей сбоев» открывает список пайплайнов проекта, отфильтрованный по неуспешным запускам. Выбранная в отчёте ветка переносится в этот список фильтром; со значением «Все ветки» список открывается без фильтра по ветке.
Графики
График «Продолжительность» содержит по линии на каждый перцентиль продолжительности пайплайна:
- «Медиана (50-й процентиль)»;
- «95-й перцентиль».
Вертикальная ось графика размечена в минутах.
График «Статус» содержит по столбцу на каждый день, разделённому на серии:
- «Успешные»;
- «Ошибка»;
- «Другие (отменённые, пропущенные)».
Вертикальная ось графика считает пайплайны.
Фильтры
Фильтры над графиками ограничивают метрики и оба графика:
| Фильтр | Значения |
|---|---|
| «Источник» | Событие, создавшее пайплайн: «Push», «Расписание», «Событие запроса на слияние» и остальные. По умолчанию — «Любой источник» |
| «Ветвь» | Ветка пайплайна. Изначально выбрана ветка по умолчанию проекта, а значение «Все ветки» снимает фильтр. В отчёте группы такого фильтра нет |
| «Диапазон дат» | «Прошлая неделя», «Последние 30 дней», «Последние 90 дней», «Последние 180 дней». По умолчанию — «Прошлая неделя» |
Фильтр «Ветвь» учитывает также пайплайны запросов на слияние, для которых эта ветка — исходная. Они попадают в отчёт, пока фильтр «Источник» оставлен в значении «Любой источник» или в нём выбрано «Событие запроса на слияние»; с любым другим источником в отчёт попадают запуски самой ветки.
Выбранные фильтры сохраняются в адресе страницы в параметрах source и time, поэтому настроенный отчёт можно передать ссылкой. В отчёте проекта туда же попадает ветка, в параметре branch.
Как считаются пайплайны
Отчёт учитывает пайплайны, созданные в периоде и дошедшие до завершённого статуса: успешные, неуспешные, отменённые и пропущенные. Пайплайн относится к дню своего создания, отсчитанному по UTC, поэтому пайплайн, созданный в один день и завершившийся на следующий, учитывается в дне создания.
Период заканчивается началом текущего дня, поэтому пайплайны, созданные сегодня, в отчёт не попадают, а на графиках нет точки за сегодня.
Перцентили графика «Продолжительность» и метрика «Медианная продолжительность» не учитывают запуски без продолжительности и запуски с нулевой продолжительностью. За день без таких запусков точки на графике нет, а за период без таких запусков вместо медианы показан прочерк.
Отчёт группы с теми же фильтрами и периодом обновляется не чаще раза в минуту, поэтому при повторном просмотре он может отставать от текущего состояния до минуты. Отчёт проекта формируется по каждому запросу.
Если отчёт строится слишком долго, вместо графиков страница показывает сообщение об этом и предлагает сузить отчётный период. Выберите меньшее значение «Диапазона дат» и откройте отчёт заново.