ClickHouse

GitLab 에서 고급 분석 기능을 위해 보조 데이터 저장소로 사용하는 ClickHouse 를 설정하고 운영하는 방법을 설명합니다.

히스토리 GitLab 18.11에서 GitLab Self-Managed 대상으로 일반 공급(GA) 되었습니다. ClickHouse 는 오픈소스 칼럼 지향 데이터베이스 관리 시스템입니다. 대규모 데이터 세트에 걸쳐 효율적으로 필터링, 집계, 쿼리를 수행할 수 있습니다. GitLab은 GitLab Duo, SDLC 트렌드, CI Analytics 등 고급 분석 기능을 지원하기 위해 ClickHouse를 보조 데이터 저장소로 사용합니다. GitLab은 이러한 기능을 지원하는 데이터만 ClickHouse에 저장합니다. ClickHouse를 GitLab에 연결할 때는 ClickHouse Cloud 를 사용하는 것을 권장합니다. 또는 직접 준비한 ClickHouse 를 사용할 수도 있습니다. 자세한 내용은 GitLab Self-Managed를 위한 ClickHouse 권장 사항 을 참고합니다. ClickHouse로 사용할 수 있는 분석 기능 # ClickHouse를 구성하면 다음 분석 기능을 사용할 수 있습니다. 기능 설명 러너 플릿 대시보드 러너 사용률 지표와 작업(job) 대기 시간을 표시합니다. 프로젝트별로 러너 유형 및 작업 상태에 따른 작업 수와 실행된 러너 분(minute)을 담은 CSV 파일 내보내기를 제공합니다. 기여 분석 시간 경과에 따른 그룹 구성원 기여도(푸시 이벤트, 이슈, 머지 리퀘스트) 분석을 제공합니다. ClickHouse는 대규모 인스턴스에서 타임아웃 문제 발생 가능성을 줄여 줍니다. GitLab Duo 및 SDLC 트렌드 GitLab Duo가 소프트웨어 개발 성과에 미치는 영향을 측정합니다. 개발 지표(배포 빈도, 리드 타임, 변경 실패율, 복구 시간)와 AI 관련 지표(GitLab Duo 시트 도입률, Code Suggestions 수락률, GitLab Duo Chat 사용률)를 함께 추적합니다. AI 지표용 GraphQL API AiMetrics , AiUserMetrics , AiUsageData 엔드포인트를 통해 GitLab Duo 및 SDLC 트렌드 데이터에 프로그래밍 방식으로 접근할 수 있도록 제공합니다. BI 도구 및 맞춤형 분석과 연동할 수 있도록 사전 집계된 지표와 원시 이벤트 데이터 내보내기를 제공합니다. 지원되는 ClickHouse 버전 # 지원되는 ClickHouse 버전은 사용 중인 GitLab 버전에 따라 다릅니다. GitLab 17.7 이상은 ClickHouse 23.x를 지원합니다. ClickHouse 24.x 또는 25.x를 사용하려면 우회 방법 을 사용합니다. GitLab 18.1 이상은 ClickHouse 23.x, 24.x, 25.x를 지원합니다. GitLab 18.8 이상은 ClickHouse 23.x, 24.x, 25.x와 Replicated 데이터베이스 엔진을 지원합니다. 이전 버전의 클러스터에는 추가 권한( dictGet )이 필요합니다. 스니펫 을 참고합니다. GitLab 19.0 이상은 ClickHouse 25.x와 26.6 까지의 26.x를 지원합니다. ClickHous