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

以下の例では、オールインワンイメージ用の手順に従って ClickStack を起動し、ローカルの ClickHouse インスタンスまたは ClickHouse Cloud インスタンスに接続していることを前提とします。

ClickHouse Cloud における HyperDX

このサンプルデータセットは、記載のとおり手順に対してごくわずかな調整を行うだけで、ClickHouse Cloud における HyperDX でも利用できます。ClickHouse Cloud で HyperDX を使用する場合は、このデプロイメントモデルの入門ガイドで説明されているように、ローカルで OpenTelemetry コレクターを実行しておく必要があります。

HyperDX UIへ移動する

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

インジェスト API key をコピーする

ClickHouse CloudのHyperDX

ClickHouse CloudでHyperDXを使用する場合は、この手順は不要です。インジェストキーのサポートは現在提供されていません。

Team Settings に移動し、API Keys セクションから Ingestion API Key をコピーします。このインジェスト API key により、OpenTelemetry コレクターを通じたデータインジェストが安全に行われます。

サンプルデータのダウンロード

UIにサンプルデータを投入するには、次のファイルをダウンロードしてください:

サンプルデータ

# curl
curl -O https://storage.googleapis.com/hyperdx/sample.tar.gz
# または
# wget https://storage.googleapis.com/hyperdx/sample.tar.gz

このファイルには、当社の公開OpenTelemetry demo（マイクロサービスで構成されたシンプルなeコマースストア）から取得したログ、メトリクス、トレースのサンプルが含まれています。このファイルを任意のディレクトリにコピーしてください。

サンプルデータの読み込み

このデータをロードするには、デプロイ済みのOpenTelemetry（OTel）コレクターのHTTPエンドポイントに送信するだけです。

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

ClickHouse CloudのHyperDX

ClickHouse CloudでHyperDXを使用する場合は、この手順は不要です。インジェストキーのサポートは現在提供されていません。

# API キーをエクスポート
export CLICKSTACK_API_KEY=<YOUR_INGESTION_API_KEY>

以下のコマンドを実行して、OTel collectorにデータを送信します。

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

これは、OTel collectorにデータを送信するOTLPログ、トレース、およびメトリクスのソースをシミュレートします。本番環境では、これらのソースは言語クライアントや他のOTel collectorになります。

Searchビューに戻ると、データの読み込みが開始されていることが確認できます（データが表示されない場合は、時間枠をLast 1 hourに調整してください）：