Splunk Observability Cloud のブラウザインストルメンテーションのトラブルシューティング

インストルメンテーションされた Web アプリケーションが Splunk Observability Cloud にデータを送信しない、またはデータが欠落している場合は、以下の手順に従って問題を特定し、解決してください。

ブラウザ RUM エージェントを使用してブラウザまたは Web アプリケーションをインストルメンテーションしているにもかかわらず、Splunk Observability Cloud にデータが表示されない場合は、以下のトラブルシューティング手順に従ってください。

ブラウザ RUMインストルメンテーションのトラブルシューティングの一般的な手順

以下の手順は、ブラウザRUMエージェントの問題のトラブルシューティングに役立ちます：

  1. 互換性と必要条件をチェック

  2. 複数のエージェントを利用していないか確認する

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

互換性と必要条件をチェック

互換性のあるバージョンと要件の完全なリストについては、「互換性と必要条件をチェック」を参照してください。

ブラウザ RUM は、splunk-otel-web-legacy.js バージョンのエージェントを介して Internet Explorer 11 をサポートします。Internet Explorer からデータを収集する必要がある場合は、必ずそのバージョンを使用してください。

複数のエージェントを利用していないか確認する

一部の開発およびオブザーバビリティツールは、Splunk RUM と同様の機能を備えています。クラッシュレポートなど、同じ目的で複数のツールを使用すると、未定義の動作が発生する可能性があります。各目的にツールを 1 つだけ使用してください。

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

デバッグロギングを有効にすると、ブラウザRUMインストルメンテーションの問題のトラブルシューティングに役立ちます。

ロギングを有効にするには、SplunkRum.init に debug: true の設定を追加します。例：

<script src="https://cdn.signalfx.com/o11y-gdi-rum/latest/splunk-otel-web.js" crossorigin="anonymous"></script>
<script>
      SplunkRum.init(
      {
         beaconEndpoint: 'https://rum-ingest.us0.signalfx.com/v1/rum'
         rumAccessToken: 'ABC123...789',
         applicationName: 'my-awesome-app',
         version: '1.0.1',
         debug: true
      });
</script>
注: デバッグロギングは必要な場合にのみ有効にします。デバッグモードでは、より多くのリソースが必要です。

Web アプリのデータが Splunk RUM に表示されない

Splunk RUM で Web アプリのテレメトリが見つからない場合は、以下をお試しください。

開発者ツールを使ってエラーをチェックする

ブラウザの開発者ツールを使って、ブラウザ RUM エラーをチェックしてください。

  • コンソールで設定エラーを確認してください。コンソールではエラーの先頭に SplunkRum: が付きます。

  • ブラウザの開発者ツールで [Network] タブをチェックし、エージェントがデータを送信していることを確認します。

    • rum-ingest.<realm>.signalfx.com にリクエストが送信されていることを確認します。

    • リクエストのステータスが 429 の場合、セッションクォータを超えている可能性があります。「Splunk RUM のシステム制限」を参照してください。

    • ブラウザの拡張機能や特定の設定によってリクエストがブロックされていないことを確認してください。

  • シミュレータのデバッグログを検索するには、デバッグロギングを有効にします。「デバッグロギングを有効にする」を参照してください。

RUMのコンフィギュレーション設定を確認する

メインコンフィギュレーション設定の値をチェックします：

  • カスタム beaconEndpoint を定義している場合は、その値が正しいことを確認してください。

  • rumAccessToken と realm の値が正しく定義されていることを確認します。

    • RUMトークンはアクティブでなければならず、データを送信しようとしている組織の一部でなければなりません。

    • レルムは、組織のレルムと同じでなければなりません。

Splunk レルムを見つけるには、「Note about realms」を参照してください。

RUM の初期化方法をチェックする

エージェントを同期的に、できるだけ早い段階で初期化していることを確認してください。「ブラウザ RUM エージェントのロードと初期化」を参照してください。

ブラウザRUMがサイトで問題を引き起こしている

ブラウザ RUMがウェブサイトに問題を引き起こしているかもしれない、あるいは既存の動作やデザインを壊しているかもしれないとお考えの場合は、以下をご確認ください：

  • 問題が発生している環境と同じ環境で、ブラウザ RUM を削除または無効化した後、サイトが期待通りに動作することを確認してください。

  • すべてのインストルメンテーションをオフにした状態で、ブラウザ RUM をアクティブにしてみてください。詳細については、「インストルメンテーション設定」参照してください.。例：

    instrumentations: {
  // Comment out lines one by one to turn on each item
  // and test which instrumentation is causing issues.
  document: false,
  errors: false,
  fetch: false,
  interactions: false,
  longtask: false,
  postload: false,
  webvitals: false,
  xhr: false,
}

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______

ブラウザ開発ツールでSplunkインストルメンテーションからのイベントを表示する

ブラウザ開発者ツールに splunk-otel-web.js や SplunkContextManager などの Splunk OTel インストルメンテーションからのネットワークリクエストが表示される場合、これはアプリケーションコードがインストルメンテーションを呼び出し、それがブラウザ API を呼び出すためです。その結果、ブラウザ開発ツールは、そのようなイベントが RUM エージェントによって開始されたことを示します。

ネットワークリクエストに移動し、イニシエータ列の値にカーソルを合わせるか選択することで、元のアプリケーションコードのイニシエータを特定することができます（たとえば、splunk-otel-web.js）。これにより、スタックトレースからの追加のイベントが表示されます。

また、インストルメンテーション レイヤーをイニシエータリストから除外するように、ブラウザの開発者ツールを設定することもできます。詳細については、ブラウザのドキュメントを参照してください。