Аналитика проекта Orbit

Вкладка Analytics предоставляет полную картину того, как ведёт себя проект: сколько времени занимают сборки, как часто они завершаются успешно, какую часть минут сборки и пропускной способности вашего плана использует проект, и где тратится время при медленной сборке.

Где находится Analytics

Откройте Orbit, нажмите на проект и выберите Analytics в группе Observability в полосе вкладок проекта. Страница озаглавлена Analytics и охватывает производительность сборки, трафик и частоту развёртываний для этого проекта.

Две соседние вкладки разбивают одни и те же данные по-разному. Build Insights сосредотачивается на процентилях длительности сборки и поведении кеша, а Web Vitals охватывает производительность для реальных пользователей. См. Orbit Build Insights и Orbit Web Vitals.

Карточки сводки

В верхней части расположены пять карточек:

Использование в этом месяце

Ниже карточек находится панель под заголовком Usage this month, показывающая название вашего плана и уточняющая, что эти цифры относятся ко всему аккаунту, а не к отдельному проекту. Нарисованы два индикатора:

• Build minutes (минуты сборки), используется в сравнении с месячным лимитом вашего плана; доля этого проекта выделена отдельно, показаны оставшиеся минуты.
• Bandwidth (origin) (пропускная способность источника), та же форма в гигабайтах.

Если вы превышаете лимит, панель показывает превышение и его стоимость: минуты сборки тарифицируются по US$0.05 за минуту, а пропускная способность источника по US$0.03 за ГБ, поверх стоимости вашего плана.

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

Build Insights

Блок Build Insights читает данные и выдаёт наблюдение для вас на простом языке, вместо того чтобы оставлять вас с необходимостью искать его на диаграмме. То, что появляется, зависит от того, что верно для вашего проекта, например:

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

Рассматривайте их как подсказки, а не вердикты. Каждое указывает на раздел далее на странице с базовыми цифрами.

Частота развёртываний, надёжность и активность

Три визуализации охватывают ритм:

• Deploy frequency: last 30 days (частота развёртываний: последние 30 дней) показывает развёртывания в день.
• Reliability: last 8 weeks (надёжность: последние 8 недель) складывает успешные против неудачных в неделю с трендом по сравнению с предыдущими четырьмя неделями.
• Deploy activity: past year (активность развёртывания: прошлый год) это календарная тепловая карта, затенённая по объёму и раскрашенная по тому, завершились ли развёртывания дня успешно.

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

Производительность сборки

Build performance (производительность сборки) отображает последний запуск успешных развёртываний как столбцы со средним и самым быстрым временем сборки и процентом попаданий в кеш. При наведении на столбец показывается ветка и коммит, а также попадён ли кеш при этой сборке.

Build time trend (тренд времени сборки) уменьшает каждую неделю до её P50 и показывает, быстрее или медленнее на этой неделе.

Build time percentiles (процентили времени сборки) даёт P50, P90 и P99. Подстрочное примечание это важная часть: более низкий P90 означает более согласованные сборки. Если ваш P50 в норме, но ваш P90 в три раза выше, то большинство сборок быстрые и что-то иногда идёт совсем неправильно, что отличается от проблемы равномерной медленности.

Эффективность кеша

Блок Cache efficiency (эффективность кеша) сравнивает холодные сборки против закешированных сборок напрямую: среднюю длительность каждой, общее сэкономленное время и результирующее улучшение скорости.

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

Per-environment build stats (статистика сборки для каждого окружения) разбивает сборки и попадания в кеш по production, staging и preview, где вы узнаёте, что previews потребляют большинство ваших минут сборки.

Статистика по веткам и авторам

Две таблицы охватывают последние 30 дней:

• Per-branch build stats (статистика сборки по ветвям): развёртывания, процент успеха и среднее время сборки по ветке.
• Per-author deploy stats (статистика развёртыван по авторам): то же самое по человеку, который сделал push.

Таблица по ветвям это практичная. Ветка с низким процентом успеха обычно это ветка со сломанным тестом или проверкой типов, которую все научились игнорировать.

Время ожидания в очереди и время суток

Build queue wait: last 14 days (время ожидания в очереди сборки: последние 14 дней) измеряет промежуток между постановкой сборки в очередь и началом работы на ней. Подстрочное примечание устанавливает ожидание: менее пяти секунд это типично, а всплески указывают на перегруженность.

Build time by hour: last 90 days (время сборки по часам: последние 90 дней) это тепловая карта по дню недели и часу дня в UTC, показывающая, когда ваши сборки медленнее всего, с ячейками, требующими минимум двух сборок перед затенением. В сочетании с временем ожидания в очереди это показывает, медленная ли ваша сборка или это напряженный момент.

Причины сбоев

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

Это самый быстрый путь от "наши сборки постоянно падают" к конкретной вещи, которую нужно исправить. Если две трети сбоев это сбои установки, проблема в разрешении зависимостей, а не в вашем коде. Troubleshooting Failed Builds охватывает, что делать с каждой категорией.

Размер артефакта

Artifact size over time (размер артефакта со временем) отслеживает, насколько велик результат каждой сборки, отмечен как растущий, сокращающийся или стабильный, с самыми старыми и самыми новыми размерами.

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

Веб-аналитика

Нижний раздел показывает Core Web Vitals от реальных посетителей за последние 30 дней, с топ-страницами, странами, рефереры и производительность p75 для каждой страницы.

Если вы ещё не добавили фрагмент сбора данных, этот раздел пуст и предлагает ссылку для настройки. См. Orbit Web Vitals для фрагмента и значения каждой метрики.

Что дальше

• Orbit Build Insights для процентилей и деталей кеша.
• Orbit Spending Cap чтобы установить потолок превышения.
• Orbit Plan Limits для информации о том, что включает ваш план.