본문으로 바로가기
본문으로 바로가기

로컬 모드 전용

all-in-one 이미지와 마찬가지로, 이 포괄적인 Docker 이미지는 모든 ClickStack 컴포넌트를 함께 제공합니다:

  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector (4317 및 4318 포트에서 OTLP를 노출)
  • MongoDB (애플리케이션 상태 영구 저장용)

그러나 이 HyperDX 배포에서는 사용자 인증이 비활성화되어 있습니다

적합한 용도​

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

배포 단계​


Docker로 배포​

로컬 모드에서는 HyperDX UI가 포트 8080에서 실행됩니다.

docker run -p 8080:8080 clickhouse/clickstack-local:latest

HyperDX UI로 이동​

HyperDX UI에 접속하려면 http://localhost:8080을 방문합니다.

이 배포 모드에서는 인증이 활성화되어 있지 않으므로, 사용자 생성 화면이 표시되지 않습니다.

보유 중인 외부 ClickHouse 클러스터(예: ClickHouse Cloud)에 연결합니다.

로그인 생성

소스를 생성한 다음, 기본값은 모두 유지하고 Table 필드에 otel_logs 값을 입력합니다. 다른 설정은 모두 자동으로 감지되므로 Save New Source를 클릭하면 됩니다.

로그 소스 생성

schema 선택: Map vs JSON​

ClickStack는 기본적으로 속성을 Map(LowCardinality(String), String) 컬럼에 저장합니다. 이는 관측성 워크로드에 권장되는 schema입니다. 버킷화된 맵 시리얼라이제이션과 맵 키 및 값에 대한 텍스트 인덱스를 함께 사용하면, 동적 JSON 서브컬럼을 키별로 수집할 때 발생하는 오버헤드 없이 선택적 조회를 수행할 수 있습니다.

JSON 타입 schema는 속성 키 집합이 작고 안정적인 워크로드를 평가할 수 있도록 베타로 제공됩니다. 기본값으로는 권장되지 않습니다. 전체 비교와 JSON 지원을 활성화하는 데 필요한 env var는 Map vs JSON type에서 확인하십시오.