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

ローカルモードのみ

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 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 です。バケット化された map のシリアライゼーション と、map のキーおよび値に対するテキスト索引を組み合わせることで、動的な JSON subcolumns で発生するキーごとの取り込みオーバーヘッドなしに、必要な項目を選択的に検索できます。

JSON 型の schema は、属性キーの集合が小さく安定しているワークロードでの評価用として、ベータで利用できます。ただし、デフォルトとしては推奨されません。完全な比較と、JSON サポートを有効にするために必要な環境変数については、Map vs JSON type を参照してください。