- 기본 제공 Prometheus 스택에 연결: BYOC Kubernetes 클러스터 내부에서 실행되는 중앙 집중식 사전 설치 Prometheus 인스턴스에 연결합니다.
- ClickHouse 메트릭 직접 스크레이프: 자체 Prometheus 배포가 각 ClickHouse 서비스에서 노출하는
/metrics_all엔드포인트를 스크레이프하도록 설정합니다.
권장 사항: 대부분의 사용 사례에서는 기본 제공 Prometheus 스택과 통합하는 방식을 권장합니다. 이 방식은 ClickHouse 서버 메트릭만 제공하는 것이 아니라, BYOC 배포의 모든 구성 요소(ClickHouse 서비스, Kubernetes 클러스터, 지원 서비스)에서 포괄적인 메트릭을 제공하기 때문입니다.
ClickHouse BYOC는 Kubernetes 클러스터 내에 Prometheus, Grafana, AlertManager와 선택적으로 메트릭을 장기 저장하기 위한 Thanos를 포함한 전체 Prometheus 모니터링 스택을 배포합니다. 이 스택은 다음 대상으로부터 메트릭을 수집합니다:
- ClickHouse 서버와 ClickHouse Keeper
- Kubernetes 클러스터 및 시스템 구성 요소
- 기반 인프라의 노드
Prometheus 스택 액세스
기본 제공 Prometheus 스택에 연결하려면 다음을 수행하십시오.- ClickHouse Cloud 콘솔에서 BYOC 인프라의 private load balancer를 활성화하십시오(Load Balancers 참조).
- ClickHouse 지원팀에 Prometheus 엔드포인트 URL을 요청하십시오.
- Prometheus 엔드포인트에 대한 프라이빗 네트워크 연결을 확인하십시오. 일반적으로 VPC/VNet 피어링 또는 기타 프라이빗 네트워크 구성을 통해 연결합니다.
<cloud>는 aws, gcp 또는 azure입니다. 프라이빗 엔드포인트에서는 <label>이 클라우드별로 다릅니다. AWS에서는 vpce, GCP에서는 p, Azure에서는 privatelink를 사용합니다.
Prometheus 스택 URL은 프라이빗 네트워크 연결을 통해서만 액세스할 수 있으며 인증이 필요하지 않습니다. 피어링 또는 기타 프라이빗 연결 옵션을 통해 BYOC VPC/VNet에 연결할 수 있는 네트워크에서만 액세스할 수 있습니다.
- 선호하는 모니터링 플랫폼 또는 사용자 지정 대시보드에서 Prometheus API 엔드포인트에 직접 액세스합니다.
- PromQL 쿼리를 사용하여 필요한 메트릭을 추출, 집계, 시각화합니다.
- 맞춤형 대시보드 또는 알림 파이프라인을 구축하는 데 적합합니다.
/query:
- 외부 Prometheus 인스턴스가 ClickHouse BYOC Prometheus 스택의 메트릭을 페더레이션 방식으로 가져오도록 구성하세요.
- 이렇게 하면 여러 환경이나 클러스터의 메트릭 수집을 한곳으로 통합하고 중앙에서 관리할 수 있습니다.
- 예시 Prometheus 페더레이션 구성:
메트릭 엔드포인트에 액세스하기
메트릭 엔드포인트는 ClickHouse 서비스 엔드포인트의/metrics_all 경로에서 사용할 수 있습니다:
default 사용자를 사용하거나, 메트릭 scraping 전용으로 최소 권한만 가진 사용자를 별도로 생성하는 것을 권장합니다.
필수 권한:
- 서비스에 연결하기 위한
REMOTE권한 - 관련 시스템 테이블에 대한
SELECT권한
Prometheus 구성하기
Prometheus 인스턴스가 ClickHouse 메트릭 엔드포인트를 스크레이프하도록 구성하십시오:<service-subdomain>.<byoc-subdomain>.<region>.<provider>.clickhouse-byoc.com:8443를 실제 서비스 엔드포인트로 대체하십시오<username>및<password>를 스크래핑에 사용할 사용자 자격 증명으로 대체하십시오
Grafana 설정 및 ClickHouse Mix-in 가져오기
Prometheus 인스턴스가 ClickHouse 모니터링 스택에 통합되면, 다음 단계에 따라 Grafana에서 메트릭을 시각화할 수 있습니다.- Grafana에서 Prometheus를 데이터 소스로 추가 Grafana 사이드바에서 “Data sources”로 이동한 다음 “Add data source”를 클릭하고 “Prometheus”를 선택하십시오. 연결에 필요한 Prometheus 인스턴스 URL과 자격 증명을 입력하십시오.



- ClickHouse 대시보드 가져오기 Grafana에서 대시보드 영역으로 이동한 다음 “Import”를 선택하십시오. 대시보드 JSON 파일을 업로드하거나 파일 내용을 직접 붙여넣을 수 있습니다. JSON 파일은 ClickHouse mixin 리포지토리에서 가져올 수 있습니다. ClickHouse Mix-in Dashboard JSON

- 메트릭 살펴보기 대시보드를 가져와 Prometheus 데이터 소스로 구성하면 ClickHouse Cloud 서비스의 실시간 메트릭을 확인할 수 있습니다.
