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

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

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

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

互換性と必要条件をチェック
複数のエージェントを利用していないか確認する
デバッグロギングを有効にする

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

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

ブラウザ 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 レルムを見つけるには、レルムに関する注意事項を参照してください。

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

エージェントを同期的に、できるだけ早い段階で初期化していることを確認してください。Load and initialize the Browser RUM agent を参照してください。

Browser RUM is causing issues in your site 🔗

ブラウザ 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 Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

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

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

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

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

このページは 2024年12月09日に最終更新されました。

Related Topics