Отчёт «Аналитика потоков ценности» показывает, сколько времени задачи и запросы на слияние проводят на каждой стадии своего пути от создания до закрытия или слияния. Отчёт доступен для группы и для проекта. Отчёт группы охватывает группу, её подгруппы и все их проекты.
Доступность отчёта
Отчёт группы доступен участникам группы с ролью «Наблюдатель» и выше, а также пользователям с типом «Аудитор». Участники с ролью «Гость» или «Планировщик» не видят пункт «Аналитика потоков ценности» в меню группы, а прямой адрес отвечает кодом 404. Уровень видимости группы этот доступ не расширяет: с уровнем «Публичный» или «Внутренний» пользователь, не состоящий в группе, отчёт не видит.
Отчёт проекта доступен участникам проекта с ролью «Гость» и выше, в том числе тем, кто получил роль в родительской группе, а также пользователям с типом «Аудитор». В проекте с уровнем видимости «Публичный» отчёт открыт любому посетителю, включая не выполнившего вход. С уровнем видимости «Внутренний» отчёт открыт любому пользователю, выполнившему вход. В проекте, где выключена функция «Аналитика» либо выключены одновременно задачи и запросы на слияние, пункт меню отсутствует, а прямой адрес отвечает кодом 404.
Создание, изменение и удаление потоков ценности доступно участникам с ролью «Наблюдатель» и выше в группе или проекте. В архивной группе управлять потоками ценности нельзя.
В Standard Edition страница проекта открывается в виде, описанном в разделе Страница проекта в Standard Edition.
Просмотр отчёта
Чтобы просмотреть отчёт группы:
- В верхней панели нажмите «Искать или перейти к…» и выберите группу.
- В меню группы перейдите в «Аналитика» → «Аналитика потоков ценности».
Чтобы просмотреть отчёт проекта:
- В верхней панели нажмите «Искать или перейти к…» и выберите проект.
- В меню проекта перейдите в «Аналитика» → «Аналитика потоков ценности».
Также отчёт можно открыть по прямому адресу:
| Отчёт | Адрес |
|---|---|
| Группа | https://<HOST>/groups/<GROUP>/-/analytics/value_stream_analytics |
| Проект | https://<HOST>/<GROUP>/<PROJECT>/-/value_stream_analytics |
Страница открывается на плитке «Обзор». Ссылка с параметром stage_id открывает отчёт на этой стадии. Выбранные поток ценности, стадия, период, фильтры и проекты сохраняются в адресе страницы, поэтому настроенный отчёт можно передать ссылкой.
Потоки ценности
Отчёт строится вокруг потока ценности — набора стадий, которыми измеряется путь задачи или запроса на слияние. Список потоков ценности расположен над фильтрами; пока поток не выбран, список показывает «Выберите поток создания ценности».
У группы нет встроенного потока ценности. Пока поток не создан, страница показывает «Создайте поток создания ценности, чтобы начать просмотр аналитики.»; участник, который может управлять потоками ценности, видит список с пунктом «Новый поток создания ценности».
Проект начинает со встроенного потока ценности с названием «default», который содержит встроенные стадии. Когда в проекте появляется сохранённый поток ценности, список содержит только сохранённые потоки. Встроенный поток нельзя изменить или удалить.
Список упорядочен по названию. Выбранный поток сохраняется в адресе страницы как параметр value_stream_id.
Стадии
Ряд плиток над отчётом — навигация по выбранному потоку: плитка «Обзор», затем по плитке на каждую стадию потока в порядке, заданном в потоке. У скрытой стадии плитки нет.
«Обзор» показывает плитки «Метрики жизненного цикла» и графики «Общее время» и «Задачи по типу». Стадия показывает график «Время стадии» и таблицу этой стадии.
Стадия измеряет время между своим событием начала и событием конца для одной задачи или одного запроса на слияние. Элемент попадает в стадию, когда достиг события конца; элемент, достигший только события начала, не учитывается. При наведении на плитку стадии показываются «Время этапа (медиана)», «Элементы стадии», примечание «Только элементы, достигшие стоп-события.» и события стадии под подписями «Запустить» и «Остановить».
Встроенные стадии и их события:
| Стадия | Событие начала | Событие конца |
|---|---|---|
| «Задача» | «Создана задача» | «Проблема, впервые связанная с этапом или впервые добавленная на доску» |
| «Планирование» | «Проблема, впервые связанная с этапом или впервые добавленная на доску» | «Задача впервые упомянута в коммите» |
| «Написание кода» | «Задача впервые упомянута в коммите» | «Создан запрос на слияние» |
| «Тестирование» | «Сборка запроса на слияние начата» | «Последняя сборка запроса на слияние завершена» |
| «Контроль» | «Создан запрос на слияние» | «Запрос на слияние выполнен» |
| «Приёмка» | «Запрос на слияние выполнен» | «Запрос на слияние впервые развёрнут в продукцию» |
Период отчёта отбирает элементы стадии по дате: для сохранённого потока ценности — по дате события конца, для встроенного потока — по дате создания задачи или запроса на слияние.
Метрики жизненного цикла
Ряд «Метрики жизненного цикла» показывается на «Обзоре» и ограничивается периодом и фильтрами страницы:
- «Время выполнения» — медианное время в днях от создания задачи до её закрытия;
- «Время цикла» — медианное время в днях от первого коммита, упоминающего задачу, до закрытия этой задачи;
- «Новые задачи» — число задач, созданных в периоде;
- «Коммиты» — число коммитов в ветке по умолчанию за период; плитка показывается только в отчёте проекта;
- «Деплои» — число успешных развёртываний в окружения с уровнем развёртывания
production, завершённых в периоде; в отчёте группы — по проектам группы.
Медианы считаются в момент открытия страницы по самим задачам, какой бы поток ценности ни был выбран. Значение округляется до одного знака после запятой. Период плиток длится до конца своего последнего дня, поэтому работа текущего дня учитывается.
Графики
График «Общее время» показывается на «Обзоре»: по области на каждую стадию выбранного потока, сложенные друг на друга, с точкой на каждый день. Точка — средняя длительность элементов, завершивших стадию в этот день; подзаголовок графика — «Среднее время каждого этапа, сложенное в полный цикл». Скрытые стадии не учитываются. День, в который стадия ничего не завершила, рисуется пунктирной линией с названием «Нет данных» между соседними днями. Период, в котором ни одна стадия ничего не завершила, показывает «За выбранный период ни одна стадия ничего не завершила».
График «Время стадии:
Оба графика показывают среднее, а плитки и таблица стадии — медиану: один элемент с необычно долгой длительностью сдвигает точку графика.
График «Задачи по типу» показывается на «Обзоре»: по столбцу на каждый день периода с разбивкой по меткам. Столбец считает задачи, закрытые в этот день, или запросы на слияние, слитые в этот день, по дате закрытия или слияния. График настраивается списком «Метки (не более 15)» в его заголовке:
- список предлагает метки группы, а в отчёте проекта — метки проекта и его групп; поле в начале списка ищет по названию;
- отчёт открывается с первыми 10 метками в алфавитном порядке; выбор более 15 меток отклоняется с сообщением «Одновременно можно показать не более 15 меток.»;
- переключатель «Показать» под списком выбирает «Задачи» или «Запросы на слияние».
Элемент с несколькими выбранными метками считается под каждой из них. Фильтр «Метка» страницы на этот график не действует. Период без закрытых или слитых элементов с выбранными метками показывает «За выбранный период не завершено ни одной работы с метками».
Таблица стадии
Таблица выбранной стадии показывается под графиком «Время стадии». Её колонки:
| Колонка | Содержимое |
|---|---|
| «Задачи» или «Запросы на слияние» | Заголовок со ссылкой на элемент, его автор и дата создания; число элементов в стадии показано рядом с названием колонки |
| «Последнее событие» | Дата и время события конца |
| «Длительность» | Время между событием начала и событием конца |
Таблица сортируется по «Последнее событие» или «Длительность» и разбита на страницы. В отчёте группы каждая строка называет также проект элемента.
Стадия без элементов в периоде при текущих фильтрах показывает «На этом этапе нет элементов для отображения с выбранными фильтрами и в указанном диапазоне времени.» Пользователь, который не может читать элементы стадии, например задачи стадии, измеряемой событиями сборки, видит «Вам нужны права.»
Период и фильтры
Список «Диапазон дат» над отчётом задаёт период: «Прошлая неделя», «Последние 30 дней», «Последние 90 дней», «Последние 180 дней» или «Настраиваемый», который открывает поля выбора даты «От» и «В». Отчёт открывается на последних 30 днях, включая сегодняшний. Период ограничен 180 днями. Период сохраняется в адресе как параметры created_after и created_before.
Панель «Фильтровать результаты» ограничивает плитки, графики и таблицу одновременно:
- «Этап» — один этап;
- «Метка» — одна или несколько меток;
- «Автор» — один автор;
- «Ответственный» — один или несколько ответственных.
Панель предлагает только совпадение по значению. Чтобы исключить значение, добавьте фильтр в адрес страницы в форме not, например not[author_username]=<USER>; отчёт тогда показывает всё, что не соответствует значению.
В отчёте группы список «Выбрать проекты» ограничивает отчёт одним или несколькими проектами группы и её подгрупп. Выбор сохраняется в адресе как параметры project_ids[].
Свежесть данных
Сохранённый поток ценности измеряется по событиям стадий, которые фоновая задача записывает заранее; встроенный поток измеряется по самим задачам и запросам на слияние в момент запроса.
После сохранения потока ценности задача сразу обходит его стадии. Затем она запускается каждые 10 минут и читает события, появившиеся после предыдущего запуска. Пока идёт первый обход стадии, страница показывает «Данные отчёта ещё собираются, поэтому он охватывает пока лишь часть истории.» Когда первый обход завершён, страница показывает вместо этого «Данные на
Создание потока ценности
Чтобы создать поток ценности:
- Откройте отчёт группы или проекта.
- В списке потоков ценности выберите «Новый поток создания ценности». Пункт расположен под разделителем в конце списка.
- В поле «Название» введите название потока: от 3 до 100 символов, уникальное в группе или проекте.
- Расставьте стадии в разделе «Стадии». Форма открывается со встроенными стадиями в их порядке. Встроенная стадия перемещается кнопками «Переместить вверх» и «Переместить вниз» и убирается из отчёта кнопкой «Скрыть стадию», которая помечает её как «Скрыта»; кнопка «Показать стадию» возвращает её. Встроенная стадия сохраняет свои события, и удалить её нельзя.
- Чтобы добавить собственную стадию, нажмите «Добавить стадию» и заполните поля «Название стадии», «Событие начала» и «Событие конца». Для события по метке выберите метку в поле «Метка события начала» или «Метка события конца». Кнопка «Удалить стадию» убирает стадию из формы.
- Нажмите «Сохранить поток создания ценности». Страница возвращается к отчёту, который открывается на первом потоке списка.
Кнопка «Вернуть набор по умолчанию» заменяет список стадий формы встроенными стадиями в их порядке.
Поток ценности содержит от 1 до 15 стадий: форма прекращает добавлять стадии с сообщением «Поток создания ценности вмещает не более 15 стадий.», а поток без стадий отклоняется с сообщением «В потоке создания ценности должна быть хотя бы одна стадия». Название собственной стадии не может повторять название встроенной стадии или другой стадии потока. Группа или проект содержит до 50 потоков ценности.
Форма также доступна по прямому адресу:
| Форма | Адрес |
|---|---|
| Группа | https://<HOST>/groups/<GROUP>/-/analytics/value_stream_analytics/value_streams/new |
| Проект | https://<HOST>/<GROUP>/<PROJECT>/-/value_stream_analytics/value_streams/new |
События стадий
Собственная стадия открывается событием задачи или запроса на слияние и закрывается другим событием того же объекта; событие задачи и событие запроса на слияние соединить нельзя. Список «Событие конца» предлагает события, которые сочетаются с выбранным событием начала.
События задачи:
- «Создана задача»;
- «Задача впервые связана с этапом»;
- «Задача впервые добавлена на доску»;
- «Задача впервые назначена»;
- «Задача впервые упомянута в коммите»;
- «Задаче добавлена метка»;
- «У задачи снята метка»;
- «Задача последний раз изменена»;
- «Задача закрыта»;
- «Задача впервые развёрнута в рабочей среде».
События запроса на слияние:
- «Создан запрос на слияние»;
- «В запрос на слияние сделан первый коммит»;
- «Запрос на слияние впервые назначен»;
- «Запросу на слияние впервые назначен проверяющий»;
- «Запросу на слияние добавлена метка»;
- «У запроса на слияние снята метка»;
- «Сборка запроса на слияние начата»;
- «Последняя сборка запроса на слияние завершена»;
- «Запрос на слияние последний раз одобрен»;
- «Запрос на слияние последний раз изменён»;
- «Запрос на слияние выполнен»;
- «Запрос на слияние закрыт»;
- «Запрос на слияние впервые развёрнут в продукцию».
Пары ограничены теми, которые читаются вперёд во времени:
- «Создана задача» и «Создан запрос на слияние» только открывают стадию; «Задача впервые развёрнута в рабочей среде» и «Запрос на слияние впервые развёрнут в продукцию» только закрывают её.
- Событие о первом случае («Задача впервые назначена», «Задача впервые связана с этапом», «В запрос на слияние сделан первый коммит») не закрывает стадию, открытую событием о последнем случае («Задача закрыта», «Запрос на слияние последний раз одобрен», «У задачи снята метка»), потому что первый случай раньше последнего.
- «В запрос на слияние сделан первый коммит» не закрывает стадию, открытую событием «Создан запрос на слияние»: первый коммит запроса на слияние раньше самого запроса. «Сборка запроса на слияние начата» не закрывает стадию, открытую событием «Последняя сборка запроса на слияние завершена».
- «Задаче добавлена метка», «У задачи снята метка», «Запросу на слияние добавлена метка» и «У запроса на слияние снята метка» принимают по метке, поэтому событие по метке может открывать и закрывать одну и ту же стадию: стадия тогда измеряет время от одной метки до другой.
Изменение потока ценности
Чтобы изменить сохранённый поток ценности:
- В списке потоков ценности выберите поток.
- Нажмите «Редактировать» рядом со списком.
- Измените название и стадии так, как они задаются в разделе Создание потока ценности. Стадия, убранная из формы, удаляется из потока при сохранении.
- Нажмите «Сохранить поток создания ценности».
Кнопка «Редактировать» показывается участнику, который может управлять потоками ценности, и только пока выбран сохранённый поток.
Удаление потока ценности
Чтобы удалить сохранённый поток ценности:
- В списке потоков ценности выберите поток.
- В списке под разделителем выберите «Удалить
», где <NAME>— название выбранного потока. - В диалоге «Удалить
?» нажмите «Удалить». Диалог сообщает: «Поток создания ценности и его стадии будут удалены. Измеренная ими активность — нет.»
После удаления список читается заново, и выбирается его первый поток. В проекте после удаления последнего сохранённого потока в список возвращается встроенный поток «default».
Страница проекта в Standard Edition
В Standard Edition страница проекта открывается без описанных выше дополнений:
- отчёт содержит встроенный поток «default» и его встроенные стадии; списка потоков ценности нет, а адреса формы отвечают кодом
404; - ряд «Метрики жизненного цикла» содержит «Новые задачи», «Коммиты» и «Деплои»; плиток «Время выполнения» и «Время цикла» нет;
- графиков «Общее время», «Время стадии» и «Задачи по типу» и строки о свежести данных нет;
- список «Диапазон дат» и панель «Фильтровать результаты» работают так, как описано в разделе Период и фильтры, а таблица стадии — как описано в разделе Таблица стадии.