메인 콘텐츠로 건너뛰기
올인원 이미지와 마찬가지로, 이 포괄적인 Docker 이미지는 모든 ClickStack 구성 요소를 포함합니다:
  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector (포트 43174318에서 OTLP를 노출)
  • MongoDB (애플리케이션 상태를 영구적으로 저장하기 위한 용도)
다만, 이 HyperDX 배포판에서는 사용자 인증이 비활성화되어 있습니다

적합한 용도

  • 데모
  • 디버깅
  • HyperDX를 사용하는 개발 환경

배포 단계


1

Docker로 배포

로컬 모드에서는 8080 포트에 HyperDX UI가 배포됩니다.
docker run -p 8080:8080 clickhouse/clickstack-local:latest
2

HyperDX UI로 이동

HyperDX UI에 접속하려면 http://localhost:8080으로 이동하십시오.이 배포 모드에서는 authentication이 활성화되어 있지 않으므로 사용자를 생성하라는 메시지가 표시되지 않습니다.ClickHouse Cloud와 같은 외부 ClickHouse 클러스터에 연결하십시오.소스를 생성하고 기본값은 모두 그대로 유지한 다음, Table 필드에 otel_logs를 입력하십시오. 나머지 설정은 모두 자동으로 감지되므로 Save New Source를 클릭하면 됩니다.

스키마 선택: Map vs JSON

ClickStack는 기본적으로 속성을 Map(LowCardinality(String), String) 컬럼에 저장합니다. 이는 관측성 워크로드에 권장되는 스키마입니다. 버킷 기반 맵 직렬화와 맵 키 및 값에 대한 텍스트 인덱스를 함께 사용하면, 동적 JSON 서브컬럼에서 발생하는 키별 수집 오버헤드 없이 필요한 항목만 선택적으로 조회할 수 있습니다. JSON 타입 스키마는 속성 키 집합이 작고 안정적인 워크로드에서 평가할 수 있도록 베타로 제공됩니다. 기본값으로는 권장되지 않습니다. 전체 비교 내용과 JSON 지원을 활성화하는 데 필요한 환경 변수는 Map vs JSON type에서 확인하십시오.
마지막 수정일 2026년 6월 10일