관리자용 러너 플릿 대시보드
관리자용 러너 플릿 대시보드
GitLab 관리자는 러너 플릿 대시보드를 이용해 인스턴스 러너의 상태를 한눈에 점검할 수 있어요. 대시보드에는 최근에 러너 인프라 때문에 발생한 CI 오류, 가장 바쁜 러너에서 동시에 실행된 job 수, 인스턴스 러너가 사용한 컴퓨트 분, job 대기열 시간 같은 정보가 표시됩니다. 이 글에서 대시보드 지표와 사용법, 컴퓨트 분 내보내기까지 정리할게요.
출처: 문서
본문
- Tier: Ultimate
- Offering: GitLab Self-Managed
GitLab 관리자로서 러너 플릿 대시보드를 사용해 인스턴스 러너의 상태를 점검할 수 있어요. 러너 플릿 대시보드가 보여주는 정보는 다음과 같습니다.
- 러너 인프라로 인해 발생한 최근 CI 오류
- 가장 바쁜 러너에서 동시에 실행된 job 수
- 인스턴스 러너가 사용한 컴퓨트 분
- job 대기열 시간
대시보드 지표
러너 플릿 대시보드에서 확인할 수 있는 지표는 다음과 같아요.
Runner usage와 Wait time to pick a job 지표를 보려면 ClickHouse 통합을 구성해야 합니다.
개요를 보려면 ClickHouse로 러너 플릿 대시보드 설정하기 영상을 참고하세요.
- Online — 인스턴스 전체에서 온라인 상태인 러너 수예요.
- Offline — 오프라인 상태인 러너 수예요. 등록은 됐지만 GitLab에 한 번도 연결되지 않은 러너는 이 개수에 포함되지 않습니다.
- Active runners — 활성 상태인 러너의 총 수예요.
- Runner usage (이전 달) — ClickHouse 필요: 지난 달 각 프로젝트 또는 그룹 러너가 사용한 총 컴퓨트 분이에요. 비용 분석을 위해 이 데이터를 CSV 파일로 내보낼 수 있어요.
- Wait time to pick a job — ClickHouse 필요: 러너가 job을 집어 들기 전에 job이 큐에서 대기하는 평균 시간이에요. 이 지표는 러너가 조직의 목표 서비스 수준 목표(SLO) 안에서 CI/CD 작업 대기열을 처리할 수 있는지 파악하는 데 유용합니다. 이 데이터는 24시간마다 갱신돼요.
러너 플릿 대시보드 보기
전제 조건:
- 관리자여야 해요.
- Runner usage와 Wait time to pick a job 지표를 보려면 ClickHouse 통합을 구성해야 해요.
러너 플릿 대시보드를 보려면:
- 오른쪽 위에서 Admin을 선택하세요.
- 왼쪽 사이드바에서 CI/CD > Runners를 선택하세요.
- Fleet dashboard를 선택하세요.
인스턴스 러너가 사용한 컴퓨트 분 내보내기
전제 조건:
- 인스턴스에 대한 관리자 접근 권한이 있어야 해요.
- ClickHouse 통합을 구성해야 해요.
러너 사용량을 분석하려면 job 수와 실행된 러너 분이 포함된 CSV 파일을 내보낼 수 있어요. CSV 파일은 각 프로젝트의 러너 타입과 job 상태를 보여줍니다. 내보내기가 완료되면 CSV가 이메일로 전송됩니다.
인스턴스 러너가 사용한 컴퓨트 분을 내보내려면:
- 오른쪽 위에서 Admin을 선택하세요.
- 왼쪽 사이드바에서 CI/CD > Runners를 선택하세요.
- Fleet dashboard를 선택하세요.
- Export CSV를 선택하세요.
더 알아보기 (Learn more)
그룹 단위로 러너 상태를 점검하고 싶다면 그룹용 러너 플릿 대시보드 문서를 보세요. 지표를 실제로 채우려면 ClickHouse 통합 설정이 필요하다는 점도 함께 확인해 두면 좋아요.