このページでは、JavaScript エージェントの構成およびホスティングオプションについて説明します。 

JavaScript エージェントの構成

コントローラで JavaScript エージェントを構成するには、次の手順を実行します。

  1. ブラウザアプリケーションに移動します。 
  2. 左側のパネルで、[Configuration ] > [Configure the JavaScript Agent] に移動します。 
  3. ホスティングオプションを選択します。

  4. 次の手順でコードスニペットをカスタマイズします。Step 2: Advanced settings (Optional)  

  5. [Save] をクリックします。

拡張設定

次の表に、JavaScript エージェントスニペットの詳細構成を示します。これらの詳細構成は、手動で追加することも、コントローラ 20.7.0 以降を使用して追加することもできます。[Use HTTPS by default] などの UI のボックスをオンにすると、JavaScript スニペットが選択を反映して自動的に更新されます(UI スニペットに config.useHTTPSAlways = true が追加されるなど)。

SaaS コントローラ 20.7.0 以降で使用可能手動構成の手順要約

デフォルトでHTTPSを使用するJavaScriptエージェントのデフォルトのトランスポートプロトコルとしてHTTPSを使用します。オフにすると、エージェントはベースページのロードに使用されるトランスポートプロトコルを選択します。

厳密なドメインにCookieを設定する厳密なフルドメイン名に対するCookieを制限します。オフにすると、Cookie は発信元ドメインの最も広範なバージョン(たとえば、*.domain.com)に設定されます。

GeoServer URLの設定

アプリケーションでインターネットIPアドレスが使用されている場合、またはユーザがVPN経由で接続している場合は、カスタムGeoServer URLを入力して、内部IPアドレスを物理的な場所にマップします。オフにした場合は、デフォルトのGeoServerを使用してエンドユーザの場所が解決されます。

リソース URL セグメントの設定リリソースURLのセグメントと文字の最大数を設定して、コントローラUIにほぼ同数のセグメントと文字を持つURLを表示します。

URLクエリ文字列の非表示デフォルトでは、URLクエリ文字列が長くなることもあれば、機密情報が含まれていることもあります。コントローラUIから完全な文字列を非表示にするには、このボックスをオンにします。

クロスドメインセッション相関セッションを有効にして、サブドメイン間で続行します。オフにすると、セッションは1つのドメインに制限され、あるドメインから別のドメインに移動するとセッションが終了します。

要求の送信元の場所を設定要求の送信元として特定のIPアドレスまたは場所を設定します。IP アドレスのみを指定することも、完全な場所(IP、国、地域、都市)を指定することもできます。

リソースオプションの設定順序付けの方法、評価するリソースの最大数、およびリソースタイミングバッファがいっぱいになったときにクリアする必要があるかどうかに基づいて、モニタするリソースを設定します。

リソース サンプリング オプションの変更リソースの順序付けの方法(サンプリングアルゴリズムを使用)および評価するリソースの最大数を変更します。

キャプチャページのタイトル[Browser Snapshots] に表示されるページタイトルをビーコンの一部としてキャプチャします。セキュリティまたはプライバシー上の理由からページタイトルを非表示にするには、この設定をオフにします。任意の URL 文字列でカスタムページタイトルを設定するには、この設定をオンにします。

SPA2 モニタリングの有効化シングルページ アプリケーション(SPA)をモニタして、仮想ページを検出し、リソース、JavaScript エラー、および AJAX リクエストを関連付けます。

SPAのリソースタイミングバッファのクリアを有効化SPA の場合、JavaScript エージェントはデフォルトで、リソースタイミングバッファに空きがなくなり、ローカルバッファにデータを保存した後にリソースタイミングバッファをクリアします。リソースタイミングデータをキャプチャするためにリソースタイミングバッファがクリアされないように、JavaScript エージェントを構成できます。 

カスタムページ名の設定このページ名は、[Pages & AJAX Requests] でのページの識別とグループ化に使用されます。オフにした場合、デフォルトのページ名はホスト名、ポート、およびパスで構成されます。

仮想ページのフィルタ処理特定の仮想ページをモニタ対象から除外するルールを設定します。

Fetch APIコールのモニタJavaScriptエージェントは、ゾーンライブラリを使用したアプリケーションを除き、角アプリケーションを含めたすべてのSPAに対してFetch APIコールをモニタします。特定の使用例では、この設定を無効にすることのみ検討してください。

AJAXリクエストの制限を設定AJAXリクエストのオーバーロードを防止するために、ベースとなる仮想ページビューごとに送信される要求の数を制限できます。この制限は、シングルページ アプリケーション(SPA)の場合は 250 個、非 SPA の場合は 50 個となります。

URL による XHR コールのフィルタリング特定のXHRコールを含めるか、除外してモニタします。

JavaScript API を使用したイベントのレポートJavaScript API を使用すると、仮想ページのさまざまな部分をロードする時間を測定し、それらのページのロードと Ajax コールを関連付けることができるように、イベントをエージェントに手動で報告できます。また、この API を使用してエラーをキャプチャし、報告することもできます。

ビーコンタイプの制限デフォルトでは、イメージビーコンの送信は無効になっていて、ビーコンは Cross-Origin Resource Sharing(CORS)でのみ送信されます。CORS ビーコンをサポートしていない古いブラウザを使用している場合は、イメージビーコンの送信を有効にできます。

ブラウザモニタリングをプログラムで無効化JavaScript エージェントが手動で挿入されたページの場合は、ヘッダーにスクリプトを追加することによって、エージェントをプログラムによって無効にできます。

window.onerror イベントの処理モニタ対象の Web ページまたはライブラリコードのいずれかのスクリプトで JavaScript window.onerror イベントが設定される場合は、window.onerror の設定直後にページにメソッド ADRUM.listenForErrors() を追加します。

キャプチャされた POST パラメータに基づいた Ajax リクエスト名の設定POST パラメータをキャプチャし、そのパラメータを使用して [Pages & Ajax Requests] で Ajax リクエストに名前を付けるように、JavaScript エージェントを構成できます。この構成により、POST パラメータに基づいて同じページから Ajax リクエストを識別してソートできます。

カスタム仮想ページ名の設定(必ずしも URL の一部ではない)任意の文字列を使用して仮想ページに名前を付けるように JavaScript エージェントを設定できます。

ページ ブラウザ スナップショットへのカスタムユーザデータの追加アプリケーションに固有のユーザ情報をブラウザのスナップショットに追加できます。この情報はキーと値のペアとして表されます。これは JavaScript エージェント構成に付加され、その後で EUM サーバに送信されるビーコンに付加されます。

プライマリメトリックの無効化アプリケーションのパフォーマンスを向上させるために、プライマリメトリックを無効化できます。 

共有ホスティングの構成

共有ホスティングを使用し、デフォルトの CDN を使用しない場合は、次の手順に従って、メインの JavaScript エージェントファイル (adrum-[version].js) のみをホストするための独自の CDN を提供します。

  1. Controller Admin,  から、[Controller Settings] に移動します。
  2. eum.jsagent.cdn.host.http および eum.jsagent.cdn.host.https の設定の値については、JavaScript エージェントファイルがホストされている URL を入力します。
  3. これらの URL が、挿入する JavaScript スニペットの URL と一致することを確認します。

自己ホスティングの構成

自己ホスティングを使用し、デフォルトの CDN を使用しない場合は、次の手順に従って、すべての JavaScript エージェントファイルをホストするための独自の CDN を提供します。

  1. Controller Admin,  から、[Controller Settings] に移動します。
  2. eum.jsagent.cdn.host.http および eum.jsagent.cdn.host.https の設定の値については、JavaScript エージェントファイルがホストされている URL を入力します。
  3. これらの URL が、挿入する JavaScript スニペットの URL と一致することを確認します。

次のステップ

JavaScript エージェントを構成したら、次のいずれかの方法でページ HTML に JavaScript スニペットを挿入します。

これらの挿入方法の違いについては、「インジェクションタイプの概要」を参照してください。