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

​
1. 연결 정보 확인

네이티브 TCP로 ClickHouse에 연결하려면 다음 정보가 필요합니다:
매개변수설명
HOST and PORT일반적으로 TLS를 사용하는 경우 포트는 9440이고, TLS를 사용하지 않는 경우 9000입니다.
DATABASE NAME기본적으로 default라는 데이터베이스가 제공됩니다. 연결하려는 데이터베이스 이름을 사용하십시오.
USERNAME and PASSWORD기본 사용자 이름은 default입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.
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년 6월 10일