Orbit
Orbit 빌드 인사이트 및 배송 인사이트
Orbit has two insight views: a per-project Build Insights tab that answers "why are our builds slow", and an account-wide Insights page that answers "how well are we shipping". This guide covers…
Orbit의 두 가지 인사이트 뷰: 프로젝트별 Build Insights 탭은 "빌드가 왜 느린가"를 답하고, 계정 전체 Insights 페이지는 "배포를 얼마나 잘하고 있는가"를 답합니다. 이 가이드는 두 가지를 모두 다루고 어떤 것을 언제 사용할지 설명합니다.
두 가지 뷰의 위치
Build Insights는 프로젝트별입니다. Orbit을 열고, 프로젝트를 클릭한 다음, 프로젝트 탭 스트립의 Observability 그룹에서 Build Insights를 선택합니다.
Insights는 계정 전체입니다. Orbit을 열고 상단 탐색에서 Insights를 선택합니다. Mission control 및 Usage 옆에 있습니다.
Build Insights: 요약 카드
이 탭은 선택한 기간 동안의 빌드 지속 시간 백분위수, 캐시 히트율, 성공률 및 추세를 설명하며, 기간은 페이지 상단에서 조정할 수 있습니다.
| 카드 | 의미 |
|---|---|
| Total builds | 실행된 빌드 수, 성공과 실패로 분류 |
| Success rate | Healthy, OK 또는 Needs attention으로 평가됨 |
| Build duration p50 | 중앙값 빌드, 아래에 p95와 p99 표시 |
| Cache hit rate | 히트 대 미스 |
| Cache savings | 캐시가 절약해준 컴퓨팅 시간 |
p50과 p95, p99의 페어링이 핵심입니다. p50이 90초이고 p99가 95초인 빌드는 잘 작동하는 빌드입니다. p50이 90초이고 p99가 11분인 빌드는 가끔 매우 잘못되는 것을 의미하며, 평균을 낸다면 이를 완전히 숨길 수 있습니다.
기간에 빌드가 없으면 페이지에 표시되며 배포가 더 오래된 경우 더 큰 기간을 선택할 것을 제안합니다.
빌드 볼륨 및 지속 시간 추세
추세 차트는 기간 동안의 일일 빌드 수를 평균 지속 시간 오버레이와 함께 표시합니다. 날짜를 가리키면 수, 성공 및 실패 분할, 평균이 표시됩니다.
두 계열을 함께 읽습니다. 볼륨 증가, 지속 시간 평탄은 더 많이 배포하는 건강한 팀입니다. 볼륨 평탄, 지속 시간 증가는 조용히 낡아가는 빌드이며, 보통 종속성 증가 또는 작동을 멈춘 캐시 때문입니다.
프레임워크 및 패키지 관리자
추세 아래에 두 가지 분류가 있습니다:
- By framework: Orbit이 감지한 프레임워크로 성공한 빌드를 그룹화합니다.
- Package managers: 모든 빌드에서.
단일 앱 프로젝트에서는 각각 한 행이며 별로 흥미롭지 않습니다. 모노레포 또는 여러 프로젝트가 있는 계정에서는 특이값을 찾을 수 있습니다: 다른 패키지 관리자를 사용하는 하나의 앱 또는 평균을 떨어뜨리는 프레임워크입니다.
프레임워크 감지는 Orbit의 기본 빌드 설정도 구동합니다: Frameworks Orbit Supports를 참조하세요.
가장 느린 빌드
Slowest 10 successful builds 테이블은 분기, 지속 시간 및 대기열 시간과 함께 최악의 수행자를 나열하며, 페이지에서 최적화의 대상 후보로 설명됩니다.
특히 Queued 열을 참고하세요. 8분 중 6분을 대기열에서 보낸 빌드는 느린 빌드가 아니라 바쁜 빌드 호스트이며, npm ci을 최적화해도 도움이 되지 않습니다. 8분을 소요하고 대기열 시간이 없는 빌드는 진정으로 느리며 개선할 가치가 있습니다.
가장 느린 빌드의 빌드 단계보다 먼저 설치 단계를 개선하세요. 설치는 따뜻한 캐시가 효과를 내는 곳이며, 보통 가장 쉬운 승리입니다. Configuring Your Build Command and Output Directory는 관련 설정을 다룹니다.
캐시 절약
이 탭은 기간 동안 빌드 캐시가 컴퓨팅 시간으로 절약해준 것을 수량화합니다. 이 숫자는 캐시를 건강하게 유지하는 주장입니다.
캐시 히트율이 낮으면 일반적인 원인은:
- 매 커밋마다 변경되어 캐시를 매번 무효화하는 잠금 파일입니다.
- 의도적으로 지워졌고 다시 워밍업되지 않은 빌드입니다.
- 배포 사이의 긴 간격입니다.
캐시를 지우면 이것을 초기화합니다. 디버깅하면서 습관처럼 지우기 전에 기억할 가치가 있습니다.
배포 인사이트: DORA 메트릭
계정 전체 Insights 페이지는 지난 30일을 모든 프로젝트에 걸쳐 다루며, 숫자를 DORA 메트릭으로 표현합니다. Elite, High, Medium 또는 Low의 성능 밴드와 이전 30일과의 비교가 있습니다.
| 메트릭 | 페이지의 정의 |
|---|---|
| Deploy frequency | 배포 빈도, 모든 환경, 모든 프로젝트 |
| Lead time (P50) | 커밋 대기열에서 배포까지, P95 함께 표시 |
| Change failure rate | 실패한 프로덕션 배포 |
| MTTR (median) | 실패에서 다음 프로덕션 성공까지 |
이 네 가지는 의도적으로 긴장 관계에 있습니다. 월 1회 배포하여 변경 실패율을 완벽하게 보이도록 할 수 있고, 끊임없이 배포하고 사물을 깨뜨려 배포 빈도를 우수하게 보이도록 할 수 있습니다. 이 세트는 함께 읽을 때만 의미가 있으며, 이전 30일에 대한 추세가 절대 밴드보다 더 중요합니다.
프로젝트 분류
메트릭 아래에는 같은 30일 동안의 모든 프로젝트 테이블이 있습니다: 배포, 성공, 실패 및 평균 빌드 시간입니다.
이것은 계정을 끌어내리는 프로젝트를 찾는 가장 빠른 방법입니다: 낮은 성공률을 가진 것 또는 평균 빌드가 다른 모든 것의 몇 배인 것입니다. 다음으로 상세 정보를 위해 Build Insights 탭을 엽니다.
데이터가 전혀 없으면 페이지에 표시되며 시작하기 위해 분기로 푸시할 것을 제시합니다.
어떤 뷰를 열 것인가
- 빌드가 느립니다. 프로젝트에서 Build Insights를 엽니다. p50 대 p95를 확인한 다음 대기열 대기 시간, 그 다음 가장 느린 빌드 테이블을 확인합니다.
- 빌드가 계속 실패합니다. 비율에 대한 Build Insights, 그 다음 Analytics 탭의 실패 원인 분류를 확인합니다: Orbit Project Analytics를 참조하세요.
- 누군가 팀이 배포를 어떻게 하는지 묻습니다. 계정 전체의 Insights를 엽니다. 추세 화살표와 함께 네 가지 DORA 메트릭이 그 질문에 직접 답합니다.
- 다음에 무엇을 할지 선택합니다. 먼저 Insights로 프로젝트를 찾고, 두 번째는 원인을 찾기 위해 Build Insights를 엽니다.
문제 해결
페이지가 비어 있지만 배포를 알고 있습니다. 기간을 넓히세요. Build Insights는 예상하는 것보다 짧은 기간으로 기본 설정되며, 계정 전체 페이지는 30일로 고정됩니다.
캐시 히트율이 0입니다. 캐시가 최근에 지워졌거나 플랜에 빌드 캐싱이 포함되지 않습니다. Orbit Plan Limits를 참조하세요.
선행 시간이 엄청납니다. 선행 시간은 커밋에서 실시간까지 측정되므로, 첫 커밋 후 몇 주 후 병합된 오래된 분기는 이를 부풀립니다. 이것은 버그가 아니라 실제 정보입니다: 작업이 병합되지 않은 상태로 앉아 있음을 알려줍니다.
MTTR이 비어 있습니다. 기간 내 프로덕션 실패가 없으므로 복구할 것이 없습니다. 이것이 좋은 경우입니다.
다음으로 갈 곳
- Orbit Project Analytics는 더 완전한 프로젝트별 그림입니다.
- Troubleshooting Failed Builds는 어떤 빌드가 실패하는지 알게 되면.
- Orbit Deployment Pipeline은 커밋과 프로덕션 사이에 있는 게이트입니다.