ClickHouse에 내장

ClickStack는 ClickHouse 서버 바이너리에 직접 번들되어 있습니다. 따라서 추가 구성 요소를 별도로 배포할 필요 없이 ClickHouse 인스턴스에서 ClickStack UI(HyperDX)를 바로 사용할 수 있습니다. 이 배포 방식은 play-clickstack.clickhouse.com의 공개 데모와 유사하지만, 자체 ClickHouse 인스턴스와 데이터를 대상으로 실행됩니다.

적합한 경우

• 최소한의 설정으로 ClickStack을 체험하려는 경우
• 관측성 UI에서 보유한 ClickHouse 데이터를 탐색하려는 경우
• 데모 및 평가용

제한 사항

이 내장형 버전은 운영 환경에서의 사용을 위해 설계되지 않았습니다. 다음 기능은 프로덕션 수준의 OSS 배포와 비교했을 때 제공되지 않습니다:

• 알림(Alerting)
• 대시보드 및 검색 지속성 — 세션 간에 대시보드와 저장된 검색이 유지되지 않습니다.
• 쿼리 설정 사용자 정의
• 이벤트 패턴

배포 단계

Docker

ClickHouse 시작

비밀번호가 설정된 ClickHouse 서버 이미지를 가져와 실행합니다:

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine

비밀번호 없이 실행하기

비밀번호 없이 실행하려면 기본 액세스 관리를 명시적으로 활성화해야 합니다:

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine

ClickStack UI 열기

브라우저에서 http://localhost:8123를 열고 ClickStack을 클릭합니다.

로컬 인스턴스에 연결하기 위해 사용자 이름 default와 비밀번호 password를 입력합니다.

소스 생성

기존 OpenTelemetry 테이블이 있는 경우 ClickStack이 이를 감지하여 자동으로 소스를 생성합니다.

새로 설치한 경우 소스를 생성하라는 메시지가 표시됩니다. Table 필드에 적절한 테이블 이름(예: otel_logs)을 입력하고 Save New Source를 클릭합니다.

아직 데이터가 없다면, 사용 가능한 옵션은 데이터 수집을 참고하십시오.

Binary

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를 생성할 수 있습니다:

설정	값
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 server

ClickStack UI 열기

브라우저에서 http://localhost:8123를 열고 ClickStack을 클릭합니다. 로컬 인스턴스로의 연결이 자동으로 생성됩니다.

소스 생성

기존 OpenTelemetry 테이블이 있는 경우 ClickStack이 이를 감지하여 자동으로 소스를 생성합니다.

아직 데이터가 없다면, 사용 가능한 옵션은 데이터 수집을 참고하십시오.

다음 단계

평가 단계를 넘어갈 준비가 되었다면 운영 환경에 적합한 배포를 고려하십시오:

• All-in-One — 영속성과 인증을 포함한 모든 구성 요소가 단일 컨테이너에 포함된 방식
• Docker Compose — 더 세밀한 제어를 위한 개별 구성 요소 방식
• Helm — 운영 환경 Kubernetes 배포에 권장되는 방식
• Managed ClickStack — ClickHouse Cloud에서 완전 관리형으로 제공되는 서비스