Дашборд потоков ценности

«Дашборд потоков ценности» показывает счётчики обзора группы или проекта, их метрики жизненного цикла и DORA-метрики за последние полгода по месяцам, а для группы — как её проекты оцениваются по DORA-метрикам. Дашборд группы охватывает группу, её подгруппы и все их проекты. У личного проекта, расположенного в пространстве пользователя, дашборда нет.

Дашборд не принимает ни период, ни фильтры: таблицы охватывают пять прошедших календарных месяцев и текущий месяц, а счётчики показывают последний снимок.

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

Дашборд группы доступен участникам группы с ролью «Наблюдатель» и выше, а также пользователям с типом «Аудитор». Участники с ролью «Гость» или «Планировщик» не видят пункт «Дашборд потоков ценности» в меню группы, а прямой адрес отвечает кодом 404. Уровень видимости группы этот доступ не расширяет: с уровнем «Публичный» или «Внутренний» пользователь, не состоящий в группе, дашборд не видит.

Дашборд проекта доступен участникам проекта с ролью «Гость» и выше, в том числе тем, кто получил роль в родительской группе, а также пользователям с типом «Аудитор». В проекте с уровнем видимости «Публичный» дашборд открыт любому посетителю, включая не выполнившего вход. С уровнем видимости «Внутренний» дашборд открыт любому пользователю, выполнившему вход. В проекте, где выключена функция «Аналитика» либо выключены одновременно задачи и запросы на слияние, пункт меню отсутствует, а прямой адрес отвечает кодом 404. У личного проекта нет ни пункта меню, ни страницы.

Панелям DORA нужно отдельное разрешение: таблице «DORA-метрики: », а на странице группы — также диаграмме «Оценка проектов по DORA: » и таблице «Проекты по DORA-метрике: ». Участники с ролью «Наблюдатель» и выше имеют его в группе и в проекте; пользователи с типом «Аудитор» — в группе. Без него панели остаются на странице и показывают вместо содержимого «У вас недостаточно разрешений для просмотра этой панели.» Так видят панели DORA участник с ролью «Гость», посетитель публичного проекта и пользователь с типом «Аудитор» на странице проекта.

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

Чтобы просмотреть дашборд группы:

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

Чтобы просмотреть дашборд проекта:

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

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

Панели

Страница группы содержит сверху вниз:

• карточку «Обзор »;
• счётчики «Группы», «Проекты», «Пользователи», «Задачи», «Запросы на слияние» и «Пайплайны»;
• таблицу «Lifecycle-метрики: »;
• таблицу «DORA-метрики: »;
• диаграмму «Оценка проектов по DORA: »;
• таблицу «Проекты по DORA-метрике: ».

Страница проекта содержит карточку «Обзор », счётчики «Задачи», «Запросы на слияние» и «Пайплайны» и таблицы «Lifecycle-метрики: » и «DORA-метрики: ». <NAMESPACE> в названии панели — название группы или проекта.

Панель, данные которой не удалось загрузить, показывает «Произошла ошибка.» и предлагает «Повторить».

Карточка обзора и счётчики

Карточка «Обзор » показывает аватар, полное название со ссылкой на группу или проект, тип («Группа» или «Проект») и уровень видимости («Публичный», «Внутренний» или «Приватный»).

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

На странице группы счётчики считают:

• «Группы» — подгруппы группы на всех уровнях;
• «Проекты» — проекты группы и её подгрупп;
• «Пользователи» — прямых участников самой группы; участники подгрупп, неподтверждённые приглашения и запросы доступа не учитываются;
• «Задачи», «Запросы на слияние» и «Пайплайны» — по проектам группы и её подгрупп; запрос на слияние учитывается в целевом проекте.

На странице проекта «Задачи», «Запросы на слияние» и «Пайплайны» считают сам проект.

Пока корневая группа не включила подсчёт, счётчики показывают 0, а предупреждение в начале страницы сообщает: «Счётчики обзора — группы, проекты, пользователи, задачи, запросы на слияние и пайплайны — для этой иерархии не собираются, поэтому эти панели показывают ноль.» Пользователь, который может открыть настройки корневой группы, видит далее «Включите фоновый подсчёт в настройках аналитики корневой группы.», где «настройках аналитики» — ссылка на страницу; остальные видят «Владелец корневой группы может включить фоновый подсчёт в её настройках аналитики.» Каждая панель счётчика также показывает предупреждение «Этот счётчик снимается в фоне раз в месяц, а корневая группа не включила подсчёт.»

Когда подсчёт включён, предупреждение в начале страницы исчезает; до первого снимка счётчики показывают 0, а каждая панель счётчика показывает предупреждение «Снимок этого счётчика ещё не снят. Фоновый подсчёт выполняется раз в месяц.» Когда подсчёт выключен, счётчики снова показывают 0 с первым предупреждением, какие бы снимки ни были сняты.

Включение подсчёта обзора

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

Чтобы включить подсчёт:

1. В верхней панели нажмите «Искать или перейти к…» и выберите корневую группу.
2. В меню группы перейдите в «Настройки» → «Аналитика».
3. В разделе «Дашборд потоков ценности» установите флажок «Включить фоновую агрегацию обзора». Раздел сообщает: «Счётчики обзора на дашборде снимаются в фоне раз в месяц для всей иерархии группы.», а флажок — «Без неё панели обзора не показывают счётчики.»
4. Нажмите «Сохранить изменения». Страница сообщает: «Настройки аналитики успешно обновлены.»

Страница также доступна по адресу https://<HOST>/groups/<GROUP>/-/settings/analytics.

Снимок иерархии снимается в последние три дня месяца, раз в месяц; иерархия, включившая подсчёт раньше, получает первый снимок в эти дни. Задание запускается ежечасно, и иерархия, слишком большая для одного запуска, досчитывается на следующем.

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

Таблица метрик жизненного цикла

Таблица «Lifecycle-метрики: » содержит колонку «Метрика», шесть колонок месяцев, озаглавленных месяцем и годом, колонку «Изменение (%)» и колонку «Тренд»:

• колонки месяцев — пять прошедших календарных месяцев, начиная с самого раннего, и текущий месяц по сегодняшний день; границы месяцев считаются в часовом поясе браузера;
• «Изменение (%)» — изменение последнего полного месяца относительно первой колонки, месяца пятимесячной давности; текущий месяц не сравнивается. Значок зелёный, когда изменение улучшает показатель строки, и красный в остальных случаях: для количества — рост, для длительности — снижение. Значок показывает «н/д», когда у одного из двух месяцев нет значения или более ранний месяц равен нулю;
• «Тренд» — линия по пяти прошедшим месяцам без текущего.

Каждая ячейка вычисляется в момент открытия страницы. Ячейка без значения показывает «-». Длительности указаны в днях. Значок рядом с названием строки открывает её описание. Строка, данные которой не удалось загрузить, названа в предупреждении панели «Не удалось загрузить некоторые сравнения метрик: » с кнопкой «Повторить».

Строки таблицы:

Название каждой строки — ссылка на отчёт, который её раскрывает:

• «Время выполнения» и «Время цикла» — Аналитика потоков ценности;
• «Создано задач» и «Закрыто задач» — Аналитика задач;
• «Деплои», «Медианное время до слияния» и «Пропускная способность запросов на слияние» — на странице группы Аналитика продуктивности, на странице проекта Аналитика запросов на слияние.

Таблица DORA-метрик

Таблица «DORA-метрики: » содержит те же колонки, что и таблица метрик жизненного цикла. Её строки вычисляются по production-окружениям проекта, а на странице группы — всех проектов группы и её подгрупп, из дневных значений, описанных в разделе Запись DORA-метрик:

• «Частота деплоя» — успешные развёртывания в день: развёртывания месяца, делённые на число его календарных дней, для текущего месяца — на число дней по сегодняшний;
• «Время проведения изменений» — медианное время в днях от слияния запроса на слияние до окончания развёртывания, которое его доставило; медиана берётся по дневным медианам месяца;
• «Время восстановления сервиса» — медианное время в днях от создания инцидента до его закрытия; медиана берётся по дневным медианам месяца;
• «Доля неудачных изменений» — инциденты, созданные в этом месяце, на одно развёртывание месяца, в процентах; месяц без развёртываний показывает «-».

Значок «Изменение (%)» зелёный при росте «Частота деплоя» и при снижении трёх остальных строк. Названия строк этой таблицы не являются ссылками.

Оценка проектов по DORA

Диаграмма «Оценка проектов по DORA: » есть только на странице группы. Она оценивает каждый доступный вам проект группы и её подгрупп за последний полный календарный месяц по каждой DORA-метрике и показывает по столбцу на метрику: сегменты «Высокая», «Средняя» и «Низкая» считают проекты с такой оценкой, сегмент «Нет данных» — оценённые проекты без значения этой метрики. Оси подписаны «DORA-метрика» и «Проекты». Подпись под диаграммой: «Оценено проектов за последний полный месяц: ; без DORA-данных: .», где <M> — проекты без записанного DORA-дня в этом месяце; такие проекты ни в один столбец не входят. При наведении на столбец показываются пороги его метрики.

Проект получает оценку за месяц, когда в один из дней этого месяца записано событие в одном из его production-окружений. Оценка каждой метрики:

Между двумя порогами оценка «Средняя». Когда ни один проект группы не оценён за месяц, каждый столбец относит все проекты к сегменту «Нет данных», а диаграмма добавляет «Ни один проект не получил оценку по: .»

Проекты по DORA-метрике

Таблица «Проекты по DORA-метрике: » есть только на странице группы. Она перечисляет доступные вам проекты группы и её подгрупп, у которых есть записанный DORA-день в последние два полных месяца: колонка «Проект» с аватаром и названием со ссылкой на проект, затем по колонке на каждую DORA-метрику со значением за последний полный месяц и значком его изменения относительно предыдущего месяца. Подпись над таблицей: «Показано из проектов; у нет DORA-данных за последние два месяца.»

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

Запись DORA-метрик

Четыре метрики, их дневные графики и их REST API описаны на странице «DORA-метрики».

DORA-значения записываются по окружению и по дню в момент события:

• успешное развёртывание учитывается в день его окончания; время проведения изменений измеряется от слияния каждого запроса на слияние, связанного с развёртыванием, до окончания развёртывания, когда запросы на слияние связаны с ним, через пять минут после развёртывания;
• созданный, закрытый или переоткрытый инцидент записывается в самое старое production-окружение проекта: инцидент — в день создания, время его восстановления — в день закрытия; инцидент, помеченный как дубликат, не учитывается;
• задача, у которой изменён тип на «Инцидент» или обратно либо поставлена или снята пометка дубликата, пересчитывается в день её создания и, если она закрыта, в день закрытия.

День события берётся в часовом поясе сервера. Дашборд читает только production-окружения, поэтому развёртывание в окружение другого уровня не учитывается.

За время до обновления на версию с дашбордом ничего не записано, и история задним числом не восстанавливается. Удаление окружения удаляет его записанные дни; удаление самого старого production-окружения проекта удаляет вместе с ним историю инцидентов проекта.