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

로컬 모드만 사용

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

  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector (43174318 포트에서 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를 클릭하면 됩니다.

로그 소스 생성

JSON 타입 지원

Beta feature. Learn more.
베타 기능 - 프로덕션 환경에 아직 적합하지 않음

ClickStack의 JSON 타입 지원은 베타 기능입니다. JSON 타입 자체는 ClickHouse 25.3+에서 프로덕션 환경에서 사용할 준비가 되어 있지만, ClickStack 내 통합은 아직 활발히 개발 중이며 제한 사항이 있거나, 향후 변경되거나, 버그를 포함할 수 있습니다.

ClickStack은 2.0.4 버전부터 JSON type에 대한 베타 지원을 제공합니다.

이 타입의 이점은 Benefits of the JSON type를 참고하십시오.

JSON 타입 지원을 활성화하려면 다음 환경 변수를 설정해야 합니다.

  • OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' - OTel collector에서 지원을 활성화하여 스키마가 JSON 타입을 사용해 생성되도록 합니다.
  • BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true (ClickStack 오픈 소스 배포판에서만 해당) - ClickStack UI 애플리케이션에서 지원을 활성화하여 JSON 데이터를 조회할 수 있도록 합니다.

로컬 모드 전용 이미지의 경우에는 BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true 파라미터만 설정하면 됩니다. 예를 들어:

docker run -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 clickhouse/clickstack-local:latest