Set up docs MCPClickStack는 ClickHouse 서버 바이너리에 직접 포함되어 있습니다. 즉, 추가 구성 요소를 배포하지 않고도 ClickHouse 인스턴스에서 ClickStack UI (HyperDX)에 액세스할 수 있습니다. 이 배포 방식은 play-clickstack.clickhouse.com의 공개 데모와 유사하지만, 사용자의 ClickHouse 인스턴스와 데이터를 사용한다는 점이 다릅니다.
적합한 사용 사례
- 최소한의 설정으로 ClickStack을 사용해 보려는 경우
- 관측성 UI로 보유한 ClickHouse 데이터를 살펴보려는 경우
- 데모 및 평가
제한 사항
이 내장 버전은 프로덕션 환경용으로 설계되지 않았습니다. 프로덕션 준비가 완료된 OSS 배포와 비교하면 다음 기능은 제공되지 않습니다.
배포 단계
ClickHouse 시작
비밀번호를 설정한 상태로 ClickHouse 서버 이미지를 가져와 실행합니다:
docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpineClickStack UI 열기
브라우저에서 http://localhost:8123를 열고 ClickStack을 클릭합니다.
로컬 인스턴스에 연결하려면 사용자 이름 default와 비밀번호 password를 입력합니다.
소스 생성
기존 OpenTelemetry 테이블이 있으면 ClickStack이 이를 감지하여 소스를 자동으로 생성합니다.
새로 설치한 경우 소스를 생성하라는 안내가 표시됩니다. Table 필드에 적절한 테이블 이름(예: otel_logs)을 입력하고 Save New Source를 클릭합니다.
아직 데이터가 없다면 데이터 수집에서 사용 가능한 옵션을 확인하십시오.
ClickHouse 시작
ClickHouse를 다운로드하고 시작합니다:
curl https://clickhouse.com/ | sh선택 사항: 시스템 로그 테이블 활성화
ClickHouse 자체의 내부 로그와 메트릭을 살펴보려면 서버를 시작하기 전에 작업 디렉터리에 구성 스니펫을 만드십시오:
mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
<clickhouse>
<query_log>
<database>system</database>
<table>query_log</table>
</query_log>
<query_thread_log>
<database>system</database>
<table>query_thread_log</table>
</query_thread_log>
<query_views_log>
<database>system</database>
<table>query_views_log</table>
</query_views_log>
<metric_log>
<database>system</database>
<table>metric_log</table>
</metric_log>
<asynchronous_metric_log>
<database>system</database>
<table>asynchronous_metric_log</table>
</asynchronous_metric_log>
</clickhouse>
EOF이 기능을 활성화하면 ClickStack을 연 뒤 system.query_log를 가리키는 Log Source를 생성할 수 있습니다:
| Setting | Value |
|---|---|
| Name | Query Logs |
| Database | system |
| Table | query_log |
| Timestamp Column | event_time |
| Default Select | event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms |
서버를 시작합니다:
./clickhouse serverClickStack UI 열기
브라우저에서 http://localhost:8123를 열고 ClickStack을 클릭합니다. 로컬 인스턴스 연결은 자동으로 생성됩니다.
소스 생성
기존 OpenTelemetry 테이블이 있으면 ClickStack이 이를 감지하여 소스를 자동으로 생성합니다.
아직 데이터가 없다면 데이터 수집에서 사용 가능한 옵션을 확인하십시오.
다음 단계
평가 단계를 넘어 프로덕션 환경에 적합한 배포를 고려하고 있다면, 다음 옵션을 검토하십시오:
- All-in-One — 영속성과 authentication을 포함한 모든 구성 요소를 단일 컨테이너로 제공
- Docker Compose — 더 세밀한 제어를 위한 개별 구성 요소
- Helm — 프로덕션 Kubernetes 배포에 권장
- Managed ClickStack — ClickHouse Cloud에서 제공되는 완전 관리형