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

올인원(All in One)

이 포괄적인 Docker 이미지는 모든 ClickStack 오픈 소스 컴포넌트를 포함합니다:

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

이 옵션에는 인증 기능이 포함되어 있어, 세션 및 사용자 전반에 걸쳐 대시보드, 알림, 저장된 검색을 지속적으로 유지할 수 있습니다.

적합한 사용 사례​

  • 데모
  • 전체 스택 로컬 테스트

배포 단계​


Docker로 배포​

다음 명령은 OpenTelemetry collector(포트 4317 및 4318)와 HyperDX UI(포트 8080)를 실행합니다.

docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest
이미지 이름 업데이트

ClickStack 이미지는 이제 clickhouse/clickstack-*(이전에는 docker.hyperdx.io/hyperdx/*)로 게시됩니다.

http://localhost:8080으로 이동하여 HyperDX UI에 접속합니다.

요구 사항을 충족하는 사용자 이름과 비밀번호를 입력하여 사용자를 생성합니다.

Create를 클릭하면 통합된 ClickHouse 인스턴스용 데이터 소스가 생성됩니다.

HyperDX UI

다른 ClickHouse 인스턴스를 사용하는 예시는 「ClickHouse Cloud 연결 생성하기」를 참조하십시오.

데이터 수집​

데이터를 수집하는 방법은 「데이터 수집」을 참조하십시오.

데이터와 설정 유지​

컨테이너를 다시 시작하더라도 데이터와 설정을 유지하려면, 위의 Docker 명령을 수정하여 /data/db, /var/lib/clickhouse, /var/log/clickhouse-server 경로를 마운트하면 됩니다. 예를 들어 다음과 같습니다:

# ensure directories exist
mkdir -p .volumes/db .volumes/ch_data .volumes/ch_logs
# modify command to mount paths
docker run \
  -p 8080:8080 \
  -p 4317:4317 \
  -p 4318:4318 \
  -v "$(pwd)/.volumes/db:/data/db" \
  -v "$(pwd)/.volumes/ch_data:/var/lib/clickhouse" \
  -v "$(pwd)/.volumes/ch_logs:/var/log/clickhouse-server" \
  clickhouse/clickstack-all-in-one:latest

운영 환경 배포​

다음과 같은 이유로 이 옵션은 운영 환경에 배포해서는 안 됩니다.

  • 비영구 스토리지: 모든 데이터가 Docker 기본 오버레이 파일 시스템을 사용해 저장됩니다. 이 구성은 대규모 환경에서의 성능을 보장하지 못하며, 컨테이너가 제거되거나 재시작되면 (사용자가 필요한 파일 경로를 마운트하지 않는 한) 데이터가 손실됩니다.
  • 컴포넌트 격리 부족: 모든 컴포넌트가 하나의 Docker 컨테이너 내에서 실행됩니다. 이로 인해 개별적인 확장 및 모니터링이 불가능해지고, 모든 프로세스에 cgroup 제한이 전역적으로 적용됩니다. 그 결과, 컴포넌트 간에 CPU와 메모리를 두고 경쟁이 발생할 수 있습니다.

포트 커스터마이징​

HyperDX Local이 사용하는 애플리케이션 포트(8080) 또는 API 포트(8000)를 커스터마이징하려면, 적절한 포트를 포워딩하도록 docker run 명령을 수정하고 몇 가지 환경 변수를 설정해야 합니다.

OpenTelemetry 포트는 포트 포워딩 옵션만 수정하여 간단히 변경할 수 있습니다. 예를 들어 OpenTelemetry HTTP 포트를 4999로 변경하려면 -p 4318:4318 대신 -p 4999:4318로 교체하면 됩니다.

docker run -p 8080:8080 -p 4317:4317 -p 4999:4318 clickhouse/clickstack-all-in-one:latest

ClickHouse Cloud 사용하기​

이 배포본은 ClickHouse Cloud와 함께 사용할 수 있습니다. 로컬 ClickHouse 인스턴스도 여전히 배포되지만 사용되지는 않으며, 환경 변수 CLICKHOUSE_ENDPOINT, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD를 설정하여 OTel collector가 ClickHouse Cloud 인스턴스를 사용하도록 구성할 수 있습니다.

예를 들면 다음과 같습니다.

export CLICKHOUSE_ENDPOINT=<HTTPS ENDPOINT>
export CLICKHOUSE_USER=<CLICKHOUSE_USER>
export CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>

docker run -e CLICKHOUSE_ENDPOINT=${CLICKHOUSE_ENDPOINT} -e CLICKHOUSE_USER=default -e CLICKHOUSE_PASSWORD=${CLICKHOUSE_PASSWORD} -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest

CLICKHOUSE_ENDPOINT는 포트 8443을 포함한 ClickHouse Cloud HTTPS 엔드포인트여야 합니다. 예를 들어 https://mxl4k3ul6a.us-east-2.aws.clickhouse.com:8443와 같습니다.

HyperDX UI에 접속한 후 Team Settings로 이동하여 ClickHouse Cloud 서비스에 대한 연결을 생성하고, 이어서 필요한 소스를 추가합니다. 예시 흐름은 여기를 참고하십시오.

OpenTelemetry collector 구성​

필요한 경우 OTel collector 구성을 수정할 수 있습니다. 자세한 내용은 「구성 수정」을 참조하십시오.

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 데이터를 조회할 수 있도록 합니다.

예를 들어 다음과 같습니다.

docker run -e OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest