メインコンテンツへスキップ
メインコンテンツへスキップ

ローカルモードのみ

all-in-one image と同様に、この包括的な Docker イメージには、すべての ClickStack コンポーネントが含まれています：

  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector（ポート 4317 および 4318 で OTLP を公開）
  • MongoDB（アプリケーション状態の永続化用）

ただし、この HyperDX のディストリビューションではユーザー認証は無効になっています

適した用途​

  • デモ
  • デバッグ
  • HyperDX を用いた開発

デプロイ手順​


Docker を使用してデプロイする​

ローカルモードでは、HyperDX UI がポート 8080 で動作します。

docker run -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local

HyperDX UI にアクセスする​

http://localhost:8080 にアクセスして HyperDX UI を開きます。

このデプロイモードでは認証が有効になっていないため、ユーザーアカウントの作成を求められることはありません。

ClickHouse Cloud など、ご自身の外部 ClickHouse クラスターに接続します。

ログイン作成

ソースを作成し、デフォルト値はすべてそのまま保持したうえで、Table フィールドに otel_logs を設定します。その他の設定は自動検出されるため、Save New Source をクリックできます。

ログソースの作成

JSON 型サポート​

Beta feature. Learn more.
ベータ機能 - 本番環境向けではありません

ClickStack における JSON 型サポートは ベータ機能 です。JSON 型自体は ClickHouse 25.3+ では本番環境向けとして利用可能ですが、ClickStack との統合はまだ積極的に開発中であり、制限があったり、将来的に変更されたり、不具合を含む可能性があります。

ClickStack では、バージョン 2.0.4 以降で JSON 型 をベータ機能としてサポートしています。

この型の利点については JSON 型の利点 を参照してください。

JSON 型のサポートを有効にするには、以下の環境変数を設定する必要があります。

  • OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' - OTel collector でのサポートを有効にし、スキーマが JSON 型を使用して作成されるようにします。
  • BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true - HyperDX アプリケーションでのサポートを有効にし、JSON データに対してクエリを実行できるようにします。

ローカルモード専用イメージを使用する場合、ユーザーは BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true パラメーターだけを設定すればよく、例えば次のように指定します。

docker run -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local