> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Grafana에서 ClickHouse를 사용하는 방법을 소개합니다
# Grafana용 ClickHouse 데이터 소스 플러그인
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
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에서 사용자 및 역할 만들기](/ko/concepts/features/security/access-rights) 가이드를 따라 `readonly` 사용자 프로필을 생성합니다.
2. `readonly` 사용자에게 내부 [clickhouse-go client](https://github.com/ClickHouse/clickhouse-go)에서 필요로 하는 `max_execution_time` 설정을 변경할 수 있는 충분한 권한이 있는지 확인합니다.
3. 공개 ClickHouse 인스턴스를 사용하는 경우 `readonly` 프로필에서 `readonly=2`를 설정하는 것은 권장되지 않습니다. 대신 `readonly=1`로 두고, 이 설정을 변경할 수 있도록 `max_execution_time`의 제약 조건 유형을 [changeable\_in\_readonly](/ko/concepts/features/configuration/settings/constraints-on-settings)로 설정합니다.
## 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** 데이터 소스를 선택하면 다음 페이지가 표시됩니다:
3. 서버 설정과 자격 증명을 입력합니다. 주요 설정은 다음과 같습니다:
* **Server host address:** ClickHouse 서비스의 호스트명입니다.
* **Server port:** ClickHouse 서비스의 포트입니다. 서버 구성과 프로토콜에 따라 달라집니다.
* **Protocol**: ClickHouse 서비스에 연결할 때 사용하는 프로토콜입니다.
* **Secure connection**: 서버에서 보안 연결이 필요한 경우 활성화합니다.
* **Username** and **Password**: ClickHouse 사용자 자격 증명을 입력합니다. 아직 사용자를 구성하지 않았다면 사용자 이름으로 `default`를 사용해 보십시오. [읽기 전용 사용자 구성](#2-making-a-read-only-user)을 권장합니다.
추가 설정은 [플러그인 구성](/ko/integrations/connectors/data-visualization/grafana/config) 문서를 확인하십시오.
4. **Save & test** 버튼을 클릭하여 Grafana가 ClickHouse 서비스에 연결할 수 있는지 확인합니다. 연결에 성공하면 **Data source is working** 메시지가 표시됩니다:
## 5. 다음 단계
이제 데이터 소스를 사용할 수 있습니다! [쿼리 빌더](/ko/integrations/connectors/data-visualization/grafana/query-builder)를 사용해 쿼리를 작성하는 방법을 자세히 알아보세요.
구성에 대한 자세한 내용은 [플러그인 구성](/ko/integrations/connectors/data-visualization/grafana/config) 문서를 참조하세요.
이 문서에 없는 추가 정보가 필요하면 [GitHub의 플러그인 리포지토리](https://github.com/grafana/clickhouse-datasource)를 확인하세요.
## 플러그인 버전 업그레이드
v4부터는 새 버전이 출시되면 구성과 쿼리를 업그레이드할 수 있습니다.
v3의 구성과 쿼리는 열 때 v4로 마이그레이션됩니다. 이전 구성과 대시보드는 v4에서 로드되지만, 새 버전에서 다시 저장하기 전까지는 마이그레이션 결과가 유지되지 않습니다. 이전 구성/쿼리를 열 때 문제가 발생하면 변경 사항을 버리고 [GitHub에 문제를 보고하세요](https://github.com/grafana/clickhouse-datasource/issues).
구성/쿼리가 더 최신 버전에서 생성된 경우에는 플러그인을 이전 버전으로 다운그레이드할 수 없습니다.