オープンソース版 ClickStack の利用開始

ClickStack Open Source をデプロイするために、つまり ClickHouse と ClickStack UI を自分で実行・管理する構成向けに、UI、OpenTelemetry collector、ClickHouse を単一のコンテナーにまとめたビルド済みの Docker image を提供しています。これにより、ローカルでの開発、テスト、セルフマネージド環境へのデプロイを簡単に始められます。

ClickStack のマネージド版も利用できます。詳しくは Managed ClickStack を参照してください。

これらのイメージは公式の ClickHouse Debian パッケージをベースとしており、用途に応じて選べる複数のディストリビューションを提供しています。最もシンプルな選択肢は、スタックの主要コンポーネントをすべてひとつにまとめた 単一イメージのディストリビューション です。

HyperDX UI
OpenTelemetry (OTel) collector
ClickHouse

このオールインワンイメージでは、1 つのコマンドでスタック全体を起動できるため、テスト、検証、または手早いローカルデプロイに最適です。

dockerでスタックをデプロイ

以下のコマンドは、OpenTelemetry collector (ポート 4317 と 4318) 、HyperDX UI (ポート 8080) 、および ClickHouse (ポート 8123) を起動します。

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

イメージ名の更新ClickStack のイメージは現在 clickhouse/clickstack-* として公開されています (以前は docker.hyperdx.io/hyperdx/*) 。

データと設定の永続化コンテナーの再起動後もデータと設定を保持するには、上記の docker コマンドを変更し、/data/db、/var/lib/clickhouse、/var/log/clickhouse-server の各パスをマウントします。例:

# パスをマウントするようにコマンドを変更
docker run \
  --name clickstack \
  -p 8123:8123 \
  -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

ClickStack UI に移動する

http://localhost:8080 にアクセスして、ClickStack UI (HyperDX) を開きます。複雑さの要件を満たすユーザー名とパスワードを指定して、ユーザーを作成します。HyperDX は自動的にローカルクラスターに接続し、logs、traces、metrics、sessions 用のデータソースを作成するため、すぐに使い始められます。

製品を試す

スタックをデプロイしたら、以下のデータセットのいずれかを試してみてください。ローカルクラスターを引き続き使用する場合:

Example dataset - 公開デモからサンプルデータセットを読み込み、簡単な問題を診断します。
Local files and metrics - ローカルファイルを読み込み、ローカル OTel collector を使用して OSX または Linux 上のシステムを監視します。

または、より大規模なデータセットを確認できるデモクラスターに接続することもできます。

Remote demo dataset - デモ ClickHouse service のデモデータセットを確認します。

別のデプロイモデル

ローカルモード

ローカルモードは、認証なしで HyperDX をデプロイするための方法です。 認証はサポートされていません。このモードは、認証や設定の永続化が不要な、簡単なテスト、開発、デモ、デバッグ用途を想定しています。このデプロイモデルの詳細については、“Local Mode Only” を参照してください。

ホステッド版

play-clickstack.clickhouse.com では、ローカルモードで動作する ClickStack のホステッド版を利用できます。

セルフホスト版

Docker で実行する

セルフホストのローカルモード用イメージには、OpenTelemetry Collector、ClickStack UI、ClickHouse server があらかじめ設定された状態で含まれています。これにより、アプリケーションからのテレメトリーデータを簡単に取り込み、最小限の追加セットアップで可視化できます。セルフホスト版を使い始めるには、必要なポートを公開して Docker コンテナーを実行するだけです。

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

“All in one” イメージとは異なり、ローカルモードには認証が含まれていないため、ユーザーの作成は求められません。

接続認証情報を入力する

独自の外部 ClickHouse クラスターに接続するには、接続認証情報を手動で入力できます。また、製品を手早く試したい場合は、Connect to Demo Server をクリックして、あらかじめ読み込まれたデータセットにアクセスし、セットアップ不要で ClickStack を試すこともできます。デモサーバーに接続する場合は、デモデータセットの手順に従ってデータセットを確認できます。

​dockerでスタックをデプロイ

​ClickStack UI に移動する

​製品を試す

​別のデプロイモデル

​ローカルモード

​ホステッド版

​セルフホスト版

​Docker で実行する

​接続認証情報を入力する

dockerでスタックをデプロイ

ClickStack UI に移動する

製品を試す

別のデプロイモデル

ローカルモード

ホステッド版

セルフホスト版

Docker で実行する

接続認証情報を入力する