Orbit 프로젝트 분석

Analytics 탭은 프로젝트가 어떻게 작동하는지 전체적으로 보여줍니다: 빌드에 걸리는 시간, 성공 빈도, 프로젝트가 사용 중인 플랜의 빌드 분량과 대역폭, 빌드가 느릴 때 시간이 어디로 가는지를 보여줍니다.

Analytics는 어디에 있나요

Orbit을 열고 프로젝트를 클릭한 후 프로젝트 탭 스트립의 Observability 그룹 아래에서 Analytics를 선택합니다. 이 페이지는 Analytics라고 제목이 붙어 있으며 이 프로젝트의 빌드 성능, 트래픽, 배포 빈도를 다룹니다.

인접한 두 탭은 같은 데이터를 다르게 나눕니다. Build Insights는 빌드 지속 시간 백분위수와 캐시 동작에 중점을 두고, Web Vitals는 실사용자 성능을 다룹니다. Orbit Build Insights와 Orbit Web Vitals을 참조하세요.

요약 카드

맨 위에 5개의 카드가 있습니다:

이달 사용량

카드 아래는 Usage this month이라는 제목의 패널이 있으며, 플랜 이름을 표시하고 이 수치가 프로젝트별이 아닌 계정 전체라는 것을 명확히 합니다. 2개의 미터가 표시됩니다:

• Build minutes, 플랜의 월별 할당량에 대해 사용되며, 이 프로젝트의 몫과 남은 분량이 별도로 표시됩니다.
• Bandwidth (origin), 기가바이트 단위로 동일한 형식입니다.

할당량을 초과하면 패널에 초과분과 비용을 표시합니다: 빌드 분량은 분당 US$0.05에 청구되고 origin 대역폭은 GB당 US$0.03에 청구되며, 이는 플랜에 추가됩니다.

또한 지금까지의 비율을 기반으로 월말까지 전망을 제시하고, 현재 추세를 유지할 경우 예상 초과분을 표시합니다. 이 전망이 유용한 숫자입니다. 문제가 있을 때 여전히 뭔가 할 수 있기 때문입니다.

Build Insights

Build Insights 블록은 데이터를 읽고 차트에서 발견하도록 남겨두지 않고 일반 언어로 관찰 내용을 작성합니다. 표시되는 내용은 프로젝트에 해당하는 사항에 따라 다릅니다. 예를 들어:

• 성공률 명세서, 좋은 안정성에 대한 칭찬 또는 최근 실패를 검토하라는 프롬프트.
• 지난 2주와 비교하여 빌드 시간 증가 또는 감소, 양쪽 평균이 인용됨.
• 낮은 캐시 히트율, 웜 캐시를 사용한 빌드 수 및 커밋 간 캐시 키를 안정적으로 유지하라는 조언.
• 월요일 빌드가 느린 것, 일반적으로 캐시가 주말에 만료됨을 의미.
• 성공률별 최악의 성능 브랜치.
• 평균 큐 대기 시간이 90초를 초과하면 빌드가 실행기를 대기 중입니다.

이를 판단이 아닌 단서로 취급하세요. 각각은 페이지 아래에 있는 기본 숫자가 있는 섹션을 가리킵니다.

배포 빈도, 신뢰성 및 활동

3개의 시각화가 흐름을 다룹니다:

• Deploy frequency: last 30 days는 일일 배포를 표시합니다.
• Reliability: last 8 weeks는 주당 성공한 것과 실패한 것을 쌓고, 지난 4주에 대한 추세를 표시합니다.
• Deploy activity: past year는 캘린더 히트맵이며, 볼륨으로 음영 처리되고 그 날의 배포 성공 여부로 색상이 지정됩니다.

연중 히트맵은 프로젝트가 얼마나 활동적인지 묻는 사람에게 보여줄 수 있는 것입니다. 간격과 클러스터가 즉시 표시됩니다.

빌드 성능

Build performance는 성공한 배포의 마지막 실행을 막대로 나타내고, 평균 및 가장 빠른 빌드 시간과 캐시 히트율을 표시합니다. 막대에 마우스를 가져가면 브랜치와 커밋, 그리고 그 빌드가 캐시에 히트했는지 여부가 표시됩니다.

Build time trend는 각 주를 P50으로 축소하고 이번 주가 더 빠르거나 느린지 보고합니다.

Build time percentiles는 P50, P90, P99를 제공합니다. 각주가 중요한 부분입니다: P90이 낮을수록 빌드가 더 일관적입니다. P50은 괜찮지만 P90이 3배인 경우, 대부분의 빌드는 빠르고 때때로 심각한 문제가 발생하는데, 이는 균일하게 느린 것과는 다른 문제입니다.

캐시 효율성

Cache efficiency 블록은 콜드 빌드를 캐시된 빌드와 직접 비교합니다: 각각의 평균 지속 시간, 절약된 총 시간, 결과 속도 향상입니다.

캐시된 평균이 콜드 평균보다 거의 나아지지 않으면 캐시가 복원되지만 도움이 되지 않으며, 보통 설치 단계가 빌드의 느린 부분이 아니기 때문입니다. 히트율 자체가 낮으면 캐시가 너무 자주 무효화됩니다: 모든 커밋에서 변경되는 lockfile이 그렇게 할 수 있습니다.

Per-environment build stats는 프로덕션, 스테이징, 미리보기별로 빌드와 캐시 히트를 분류하는데, 여기서 미리보기가 빌드 분량의 대부분을 수행하고 있다는 것을 알게 됩니다.

분기별 및 작성자별 통계

두 테이블이 지난 30일을 다룹니다:

• Per-branch build stats: 분기별 배포, 성공률, 평균 빌드 시간.
• Per-author deploy stats: 푸시한 사람별 동일 항목.

분기별 테이블이 실용적입니다. 낮은 성공률을 가진 분기는 보통 모두가 무시하는 법을 배운 깨진 테스트나 유형 검사가 있는 분기입니다.

큐 대기 및 시간대

Build queue wait: last 14 days는 빌드가 큐에 들어갈 때와 빌더가 그것을 선택할 때 사이의 간격을 측정합니다. 각주가 예상을 설정합니다: 5초 미만이 일반적이며, 스파이크는 경합을 나타냅니다.

Build time by hour: last 90 days는 UTC의 요일별 시간별 히트맵이며, 빌드가 가장 느린 때를 표시하고, 셀은 음영 처리되기 전에 최소 2개의 빌드가 필요합니다. 큐 대기와 함께 느린 빌드가 당신의 빌드인지 아니면 바쁜 시간인지 알려줍니다.

실패 원인

지난 30일 동안의 실패한 배포는 근본 원인별로 분류됩니다: 컴파일 오류, 설치 실패, 테스트 실패, lint 오류, 시간 초과, 메모리 부족, 네트워크 오류 또는 알 수 없음. 이 섹션은 최상위 카테고리와 실패의 몇 퍼센트를 차지하는지 강조합니다.

이것은 "우리의 빌드가 계속 실패합니다"에서 수정할 특정 항목으로의 가장 빠른 경로입니다. 실패의 3분의 2가 설치 실패인 경우, 문제는 의존성 해결이지 코드가 아닙니다. Troubleshooting Failed Builds는 각 카테고리로 수행할 작업을 다룹니다.

아티팩트 크기

Artifact size over time은 각 빌드의 출력 크기를 추적하며, 증가, 감소 또는 안정적으로 레이블을 지정하고, 가장 오래된 크기와 최신 크기를 표시합니다.

지속적으로 증가하는 아티팩트는 사이트가 느려지기 전에 조사할 가치가 있습니다. 일반적인 원인은 아무도 정리하지 않는 이미지 디렉토리와 엄청난 것을 끌어온 의존성입니다.

웹 분석

하단 섹션은 지난 30일 동안 실제 방문자로부터의 Core Web Vitals를 표시하며, 상위 페이지, 국가, 참조자, 페이지별 p75 성능을 보여줍니다.

아직 수집 스니펫을 추가하지 않은 경우 이 섹션은 비어 있으며 설정할 링크를 제공합니다. 스니펫 및 각 메트릭의 의미에 대해 Orbit Web Vitals을 참조하세요.

다음 단계

• Orbit Build Insights 백분위수 및 캐시 세부 정보용.
• Orbit Spending Cap 초과분에 한도를 설정.
• Orbit Plan Limits 플랜에 포함된 내용.