Ruby OpenTelemetryのトラブルシューティングの手順

以下の手順は、Rubyインストルメンテーションのトラブルシューティングに役立ちます：

1. デバッグロギングを有効にします。

デバッグロギングを有効にする

デバッグロギングにより、Ruby インストルメンテーションの詳細レベルが向上します。これは、問題のトラブルシューティングに役立ちます。デバッグロギングを有効にするには、OTEL_LOG_LEVEL 環境変数を debug に設定します。

export OTEL_LOG_LEVEL="debug"

この環境変数の出力がいつまでもオンのままだとシステムに過負荷をかける可能性があるため、問題解決後は必ず環境変数の設定を解除してください。

トレース・エクスポーターの問題

デフォルトで、Splunk Distribution of OpenTelemetry Ruby は OTLP エクスポータを使用します。トレースのエクスポートに影響する問題があると、デバッグログにエラーが表示されます。

OTLP がスパンをエクスポートできない

OTLPエクスポーターとOTel Collector 間の接続不足をトラブルシューティングするには、以下を試してください：

1. OTEL_EXPORTER_OTLP_ENDPOINT が正しい OpenTelemetry Collector インスタンスホストを指していることを確認します。

2. コレクタインスタンスが設定済みで、稼動していることを確認します。「Collector のトラブルシューティング」を参照してください。

3. OTLP レシーバーが OTel Collector でアクティブになり、トレースパイプラインに接続されていることを確認します。

4. OTel Collector がアドレス http://<host>:4318 を指していることを確認します。URL が正しいことを確認します。

スパン送信時の401エラー

トレースを Splunk Observability Cloud に直接送信して 401 エラーコードを受け取った場合、SPLUNK_ACCESS_TOKEN で指定した認証トークンが無効です。考えられる原因は次のとおりです。

• 値はnullです。

• 値が整形式トークンではありません。

• このトークンは、authScope が ingest に設定されているアクセストークンではありません。

Splunk プラットフォームインスタンスに直接データを送信する場合は、有効な Splunk アクセストークンを使用していることを確認してください。「Splunk Observability Cloud を使用したユーザー API アクセストークンの取得と管理」を参照してください。