はじめに
OpenTelemetry パッケージをインストールする
次のコマンドで OpenTelemetry パッケージをインストールします。OpenTelemetry + ログ用フォーマッタを設定する
次に、OpenTelemetry のトレーシング用インストルメンテーションを初期化し、 Rails ロガーのログメッセージ用フォーマッタを設定して、ログが自動的に トレースにひも付くようにします。カスタムフォーマッタがないと、ログは ClickStack 内で自動的に相関付けられません。config/initializers フォルダ内に hyperdx.rb という名前のファイルを作成し、
そこに次の内容を追加します:
環境変数を設定する
続いて、OpenTelemetry Collector 経由で ClickStack にテレメトリーを送信するため、シェルで以下の環境変数を設定する必要があります。- Managed ClickStack
- ClickStack Open Source
OTEL_SERVICE_NAME 環境変数は HyperDX アプリでサービスを識別するために使用されます。値には任意の名前を指定できます。
OTEL_EXPORTER_OTLP_HEADERS 環境変数には、HyperDX アプリの Team Settings → API Keys で確認できる API key を指定します。