otelgen は、合成OTLPログ、トレース、メトリクスを生成する小規模な Go CLI です。これを使用すると、既存の ClickStack OpenTelemetry collector がデータを受信していることや、イベントが ClickStack UI に表示されることを確認できます。
このガイドでは、collector が 4317 (gRPC) および 4318 (HTTP) の OTLP エンドポイントですでに稼働していることを前提としています。
- Managed ClickStack
- ClickStack Open Source
1
前提条件
このガイドは、Managed ClickStack の Getting Started ガイドを完了しており、otelgen を実行するマシンから到達可能な OTLP gRPC (4317) および HTTP (4318) エンドポイントで OpenTelemetry collector が稼働していることを前提としています。collector を保護して OTLP_AUTH_TOKEN を設定している場合は、その値をすぐ使えるようにしておいてください。2
3
環境変数を設定する
collector の endpoint と、collector が保護されている場合は認証トークンを export します。localhost:4317 になります。保護されていない collectorClickStack OpenTelemetry collector はデフォルトで認証なしです。collector の保護に従って
OTLP_AUTH_TOKEN を設定していない場合は、ここでは OTLP_AUTH_TOKEN を省略し、以下のコマンドから --header フラグを削除してください。4
traces を生成する
複数の span を含む traces を短時間送信します。--rate は 1 秒あたりの traces 数、--duration は実行時間 (秒) です。--insecure は gRPC connection の TLS を無効にします。これは、collector の平文 OTLP ポートを otelgen の接続先にする場合に必要です。5
logs を生成する
6
メトリクスを生成する
metrics サブコマンドは--duration に対応していません。コマンドを実行し、数秒後に Ctrl+C を押して停止してください。otelgen は metrics 配下で gauge、histogram、up-down-counter、exponential-histogram の各サブコマンドもサポートしています。7
ClickStack で確認する
ClickHouse Cloudコンソールから ClickStack UI を開きます。Search ビューでログソースを Logs と Traces の間で切り替え、新しいイベントが取り込まれていることを確認します。時間範囲を Last 15 minutes に設定します。Chart Explorer を開いて Metrics を選択し、otelgen が生成したメトリクス名の 1 つ (たとえば otelgen.metrics.sum) を chart して、メトリクスのインジェストを確認します。