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 マニュアルのチャットグループを参照してください。

Browser developer tools display events from Splunk instrumentation 🔗

If there are network requests displayed in your browser developer tools from Splunk OTel instrumentation such as splunk-otel-web.js or SplunkContextManager, this is because the application code calls the instrumentation, which then calls the browser API. As a result, your browser developer tools indicate that such events are initiated by the RUM agent.

You can identify the original application code initiator by navigating to the network request and hovering over or selecting the value in the initiator column, for example, splunk-otel-web.js. This displays additional events from the stack trace.

You can also configure your browser developer tools to omit the instrumentation layers from the initiator list. See your browser documentation for details.

This page was last updated on 2024年09月18日.

Related Topics