메인 콘텐츠로 건너뛰기
Grafana를 사용하면 대시보드를 통해 모든 데이터를 살펴보고 공유할 수 있습니다. Grafana에서 ClickHouse에 연결하려면 플러그인이 필요하며, UI에서 쉽게 설치할 수 있습니다.

​
1. 연결 정보 확인

네이티브 TCP로 ClickHouse에 연결하려면 다음 정보가 필요합니다: ClickHouse Cloud 서비스의 세부 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 연결할 서비스를 선택한 다음 Connect를 클릭하십시오: Native를 선택하면 예시 clickhouse-client 명령에서 세부 정보를 확인할 수 있습니다. 자가 관리형 ClickHouse를 사용하는 경우 연결 세부 정보는 ClickHouse 관리자가 설정합니다.

​
2. 읽기 전용 사용자 만들기

Grafana와 같은 데이터 시각화 도구에 ClickHouse를 연결할 때는 원치 않는 수정으로부터 데이터를 보호하기 위해 읽기 전용 사용자를 만드는 것이 좋습니다. Grafana는 쿼리가 안전한지 검증하지 않습니다. 쿼리에는 DELETE 및 INSERT를 포함한 모든 SQL 문이 들어갈 수 있습니다. 읽기 전용 사용자를 구성하려면 다음 단계를 따르세요:
  1. ClickHouse에서 사용자 및 역할 만들기 가이드를 따라 readonly 사용자 프로필을 생성합니다.
  2. readonly 사용자에게 내부 clickhouse-go client에서 필요로 하는 max_execution_time 설정을 변경할 수 있는 충분한 권한이 있는지 확인합니다.
  3. 공개 ClickHouse 인스턴스를 사용하는 경우 readonly 프로필에서 readonly=2를 설정하는 것은 권장되지 않습니다. 대신 readonly=1로 두고, 이 설정을 변경할 수 있도록 max_execution_time의 제약 조건 유형을 changeable_in_readonly로 설정합니다.

​
3. Grafana용 ClickHouse 플러그인 설치

Grafana가 ClickHouse에 연결하려면 먼저 적절한 Grafana 플러그인을 설치해야 합니다. Grafana에 로그인한 상태라고 가정하고, 다음 단계를 따르십시오:
  1. 사이드바의 Connections 페이지에서 Add new connection 탭을 선택합니다.
  2. ClickHouse를 검색한 다음, Grafana Labs에서 서명한 플러그인을 클릭합니다:
  3. 다음 화면에서 Install 버튼을 클릭합니다:

​
4. ClickHouse 데이터 소스 정의

  1. 설치가 완료되면 Add new data source 버튼을 클릭합니다. (Connections 페이지의 Data sources 탭에서도 데이터 소스를 추가할 수 있습니다.)
  2. 아래로 스크롤해 ClickHouse 데이터 소스 유형을 찾거나, Add data source 페이지의 검색창에서 검색할 수 있습니다. ClickHouse 데이터 소스를 선택하면 다음 페이지가 표시됩니다:
  1. 서버 설정과 자격 증명을 입력합니다. 주요 설정은 다음과 같습니다:
  • Server host address: ClickHouse 서비스의 호스트명입니다.
  • Server port: ClickHouse 서비스의 포트입니다. 서버 구성과 프로토콜에 따라 달라집니다.
  • Protocol: ClickHouse 서비스에 연결할 때 사용하는 프로토콜입니다.
  • Secure connection: 서버에서 보안 연결이 필요한 경우 활성화합니다.
  • Username and Password: ClickHouse 사용자 자격 증명을 입력합니다. 아직 사용자를 구성하지 않았다면 사용자 이름으로 default를 사용해 보십시오. 읽기 전용 사용자 구성을 권장합니다.
추가 설정은 플러그인 구성 문서를 확인하십시오.
  1. Save & test 버튼을 클릭하여 Grafana가 ClickHouse 서비스에 연결할 수 있는지 확인합니다. 연결에 성공하면 Data source is working 메시지가 표시됩니다:

​
5. 다음 단계

이제 데이터 소스를 사용할 수 있습니다! 쿼리 빌더를 사용해 쿼리를 작성하는 방법을 자세히 알아보세요. 구성에 대한 자세한 내용은 플러그인 구성 문서를 참조하세요. 이 문서에 없는 추가 정보가 필요하면 GitHub의 플러그인 리포지토리를 확인하세요.

​
플러그인 버전 업그레이드

v4부터는 새 버전이 출시되면 구성과 쿼리를 업그레이드할 수 있습니다. v3의 구성과 쿼리는 열 때 v4로 마이그레이션됩니다. 이전 구성과 대시보드는 v4에서 로드되지만, 새 버전에서 다시 저장하기 전까지는 마이그레이션 결과가 유지되지 않습니다. 이전 구성/쿼리를 열 때 문제가 발생하면 변경 사항을 버리고 GitHub에 문제를 보고하세요. 구성/쿼리가 더 최신 버전에서 생성된 경우에는 플러그인을 이전 버전으로 다운그레이드할 수 없습니다.
마지막 수정일 2026년 7월 2일