그룹용 러너 플릿 대시보드

그룹의 러너들이 실제로 잘 일하고 있는지 한눈에 파악하고 싶을 때가 있죠. 그룹에 Maintainer 또는 Owner 역할을 가진 사용자라면 러너 플릿 대시보드를 열어 그룹 러너의 상태를 점검할 수 있어요. 이 글에서는 대시보드에서 확인할 수 있는 지표와 보는 방법을 설명할게요.

출처: 문서

본문

Tier: Ultimate
Offering: GitLab.com, GitLab Self-Managed
Status: Beta
GitLab 17.0에서 베타로 도입되었으며, runners_dashboard_for_groups라는 기능 플래그가 붙어 있었어요. 기본적으로 비활성화되어 있었죠.
runners_dashboard_for_groups 기능 플래그는 GitLab 17.2에서 제거됐어요.

그룹에 대해 Maintainer 또는 Owner 역할을 가진 사용자는 러너 플릿 대시보드를 사용해 그룹 러너의 상태를 점검할 수 있습니다.

대시보드 지표

러너 플릿 대시보드에서 확인할 수 있는 지표는 다음과 같아요.

Online — 온라인 상태인 러너 수예요. Admin 영역에서는 인스턴스 전체의 러너 수를 보여주고, 그룹에서는 해당 그룹과 하위 그룹의 러너 수를 보여줍니다.
Offline — 오프라인 상태인 러너 수예요.
Active runners — 활성 상태인 러너 수예요.
Runner usage (이전 달) — 각 프로젝트가 그룹 러너에서 사용한 컴퓨트 분(compute minutes)이에요. 비용 분석을 위해 CSV로 내보낼 수도 있습니다.
Wait time to pick a job — 러너의 평균 대기 시간을 보여줘요. 이 지표는 러너가 조직의 목표 서비스 수준 목표(SLO) 안에서 CI/CD 작업 대기열을 처리할 수 있는지를 판단하는 데 도움을 줍니다. 이 지표 위젯을 만드는 데이터는 24시간마다 갱신돼요.

그룹용 러너 플릿 대시보드 보기

전제 조건:

그룹에 대해 Maintainer 역할이 있어야 해요.
GitLab Self-Managed에서 Runner usage와 Wait time to pick a job 지표를 보려면 ClickHouse 통합을 구성해야 해요.

그룹용 러너 플릿 대시보드를 보려면:

상단 바에서 Search or go to를 선택해 그룹을 찾으세요.
왼쪽 사이드바에서 Build > Runners를 선택하세요.
Fleet dashboard를 선택하세요.

GitLab Self-Managed에서 Runner usage와 Wait time to pick a job 지표를 보려면 ClickHouse 통합을 구성해야 한다는 점을 꼭 기억해 두세요.

더 알아보기 (Learn more)

인스턴스 전체 러너를 점검해야 한다면 관리자용 러너 플릿 대시보드 문서를, ClickHouse 연동과 관련한 설정이 궁금하다면 ClickHouse 통합 문서를 이어서 읽어 보세요.