ClickStack - サンプルログ、トレース、およびメトリクス

以下の例は、オールインワンイメージのインストラクションを使用してClickStackを開始し、ローカルClickHouseインスタンスまたはClickHouse Cloudインスタンスに接続したことを前提としています。

ClickHouse CloudにおけるHyperDX

このサンプルデータセットは、HyperDXをClickHouse Cloudで使用する場合にも利用できます。流れに若干の調整が必要ですが記載されています。ClickHouse CloudでHyperDXを使用する場合、ユーザーはこのデプロイメントモデルのための始め方ガイドで説明されているように、ローカルでOpen Telemetryコレクターを実行する必要があります。

HyperDX UIに移動する

ローカルにデプロイしている場合は、http://localhost:8080にアクセスしてHyperDX UIを開きます。ClickHouse CloudでHyperDXを使用している場合は、左のメニューからサービスとHyperDXを選択します。

取り込みAPIキーをコピーする

ClickHouse CloudにおけるHyperDX

ClickHouse CloudでHyperDXを使用している場合、このステップは必要ありません。そこでは現在、取り込みキーのサポートがありません。

チーム設定に移動し、APIキーセクションから取り込みAPIキーをコピーします。このAPIキーは、OpenTelemetryコレクターを通じたデータ取り込みのセキュリティを保証します。

サンプルデータをダウンロードする

UIにサンプルデータを表示するために、以下のファイルをダウンロードします：

サンプルデータ


# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz

# or

# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

このファイルには、私たちの公開されたOpenTelemetryデモからの例示的なログ、メトリクス、トレースが含まれています。これは、マイクロサービスを持つシンプルなeコマースストアです。このファイルをお好みのディレクトリにコピーしてください。

サンプルデータをロードする

このデータをロードするために、展開したOpenTelemetry (OTel) コレクターのHTTPエンドポイントに送信します。

まず、上記でコピーしたAPIキーをエクスポートします。

ClickHouse CloudにおけるHyperDX

ClickHouse CloudでHyperDXを使用している場合、このステップは必要ありません。そこでは現在、取り込みキーのサポートがありません。


# export API key
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

次のコマンドを実行してデータをOTelコレクターに送信します：

for filename in $(tar -tf sample.tar.gz); do
  endpoint="http://localhost:4318/v1/${filename%.json}"
  echo "loading ${filename%.json}"
  tar -xOf sample.tar.gz "$filename" | while read -r line; do
    echo "$line" | curl -s -o /dev/null -X POST "$endpoint" \
    -H "Content-Type: application/json" \
    -H "authorization: ${CLICKSTACK_API_KEY}" \
    --data-binary @-
  done
done

これにより、OTLPログ、トレース、およびメトリックソースがOTelコレクターにデータを送信することをシミュレートします。製品環境では、これらのソースは言語クライアントまたは他のOTelコレクターである可能性があります。

サーチビューに戻ると、データのロードが始まっていることが確認できるはずです（データが表示されない場合は、時間枠を直近1時間に調整してください）。