Splunk Observability Cloud の Ruby インストルメンテーションのトラブルシューティング 🔗
Splunk Distribution of OpenTelemetry Ruby を使用して Ruby アプリケーションをインストルメンテーションしているときに、Splunk Observability Cloud にデータが表示されない場合は、以下のトラブルシューティング手順に従ってください。
Ruby OpenTelemetryのトラブルシューティングの手順 🔗
以下の手順は、Rubyインストルメンテーションのトラブルシューティングに役立ちます：
デバッグロギングを有効にする 🔗
デバッグロギングは、Rubyインストルメンテーションの冗長性を高めます。これは問題のトラブルシューティングに役立ちます。デバッグロギングを有効にするには、OTEL_LOG_LEVEL 環境変数を debug に設定します。
export OTEL_LOG_LEVEL="debug"
この環境変数の出力がいつまでもオンのままだとシステムに過負荷をかける可能性があるため、問題解決後は必ず環境変数の設定を解除してください。
トレース・エクスポーターの問題 🔗
デフォルトでは、Splunk Distribution of OpenTelemetry Ruby は OTLP エクスポーターを使用します。トレースのエクスポートに影響する問題があると、デバッグログにエラーが出力されます。
OTLP がスパンをエクスポートできない 🔗
OTLPエクスポーターとOTel Collector 間の接続不足をトラブルシューティングするには、以下を試してください：
OTEL_EXPORTER_OTLP_ENDPOINTが正しい OpenTelemetry Collector インスタンスホストを指していることを確認します。コレクタインスタンスが構成され、稼動していることを確認します。Collector のトラブルシューティング を参照してください。
OTLP レシーバーが OTel Collector でアクティブになり、トレースパイプラインに接続されていることを確認します。
OTel Collector が次のアドレスを指していることを確認してください：
http://<host>:4318.URL が正しいことを確認してください。
スパン送信時の401エラー 🔗
トレースを Splunk Observability Cloud に直接送信して 401 エラーコードを受け取った場合、SPLUNK_ACCESS_TOKEN で指定した認証トークンが無効です。次のような理由が考えられます：
値はnullです。
値が整形式トークンではありません。
このトークンは、
authScopeが ingest に設定されているアクセストークンではありません。
Splunk プラットフォームインスタンスに直接データを送信する場合は、有効な Splunk アクセストークンを使用していることを確認してください。Splunk Observability Cloudを使用したユーザー APIアクセストークンの取得と管理 を参照してください。
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。
Splunk Observability Cloudをご利用のお客様
Splunk サポートポータル でケースを送信する
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。