Download PDF
Download page JavaScript エージェントの構成.
JavaScript エージェントの構成
このページでは、コントローラ UI で JavaScript エージェントを構成する方法について説明します。ブラウザ リアル ユーザー モニターリングを設定するには、JavaScript エージェントを構成してから、JavaScript エージェントのコードスニペットを挿入する必要があります。
JavaScript の構成にアクセスするには、次の手順を実行します。
- コントローラ UI で、ブラウザアプリケーションに移動します。
- 左側のパネルで、[Configuration ] > [Configure the JavaScript Agent] に移動します。
JavaScript エージェントの構成
コントローラで JavaScript エージェントを構成するには、次の手順を実行します。
ホスティングオプションを選択します。
次の手順でコードスニペットをカスタマイズします。Step 2: Advanced settings (Optional).
[Save.] をクリックします。
コントローラ UI での詳細構成の構成
UI ベースの詳細構成は、SaaS コントローラバージョン 20.7.0 以降で使用できます。
コントローラ UI で詳細構成を指定できます。[Use HTTPS by default] などのボックスをオンにすると、HTML スニペットが自動的に更新され、config.useHTTPSAlways = true
などのように選択が反映されます。次の表に、各設定のマニュアルと概要を示します。
構成 | 要約 |
---|---|
デフォルトでHTTPSを使用する | JavaScriptエージェントのデフォルトのトランスポートプロトコルとしてHTTPSを使用します。オフにすると、エージェントはベースページのロードに使用されるトランスポートプロトコルを選択します。 |
厳密なドメインにCookieを設定する | 厳密なフルドメイン名に対するCookieを制限します。オフにすると、Cookieは発信元ドメインの最も広範なバージョン(たとえば、* domain.com)に設定されます。 |
アプリケーションでインターネット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コールを含めるか、除外してモニタします。 |
その他の手動構成
次の表に、コントローラ UI に含まれていないその他の詳細構成を示します。
構成 | 要約 |
---|---|
JavaScript API を使用したイベントのレポート | JavaScript API を使用すると、仮想ページのさまざまな部分をロードする時間を測定し、それらのページのロードと Ajax コールを関連付けることができるように、イベントをエージェントに手動で報告できます。また、この API を使用してエラーをキャプチャし、報告することもできます。 |
ビーコンタイプの制限 | デフォルトでは、イメージビーコンの送信は無効になっていて、ビーコンは Cross-Origin Resource Sharing(CORS)でのみ送信されます。CORS ビーコンをサポートしていない古いブラウザを使用している場合は、イメージビーコンの送信を有効にできます。 |
ブラウザモニタリングをプログラムで無効化 | JavaScript エージェントが手動で挿入されたページの場合は、ヘッダーにスクリプトを追加することによって、エージェントをプログラムによって無効にできます。 |
window.onerror イベントの処理 | モニター対象の Web ページまたはライブラリコードのいずれかのスクリプトで JavaScript |
キャプチャされた POST パラメータに基づいた Ajax リクエスト名の設定 | POST パラメータをキャプチャし、そのパラメータを使用して [Pages & Ajax Requests] で Ajax リクエストに名前を付けるように、JavaScript エージェントを構成できます。この構成により、POST パラメータに基づいて同じページから Ajax リクエストを識別してソートできます。 |
カスタム仮想ページ名の設定 | (必ずしも URL の一部ではない)任意の文字列を使用して仮想ページに名前を付けるように JavaScript エージェントを設定できます。 |
ページ ブラウザ スナップショットへのカスタムユーザデータの追加 | アプリケーションに固有のユーザ情報をブラウザのスナップショットに追加できます。この情報はキーと値のペアとして表されます。これは JavaScript エージェント構成に付加され、その後で EUM サーバに送信されるビーコンに付加されます。 |
オンプレミスホスティングの構成
次の各項では、オンプレミス設定のホスティングオプションについて説明します。
オンプレミスの共有ホスティングの構成
共有ホスティングを使用し、デフォルトの CDN を使用しない場合は、次の手順に従って、次のメインの JavaScript エージェントファイルのみをホストするための独自の CDN を提供します(adrum-[version].js):
- [Controller Admin, ] から、次の場所に移動します。
theController Settingsページ. - 設定
eum.jsagent.cdn.host.http
とeum.jsagent.cdn.host.https
を見つけます。 - これらの 2 つの設定の値には
、JavaScript エージェントファイルがホストされている場所の URL を入力します。 ページに手動で挿入した HTML スニペットで、これらの URL が使用されていることを確認します。
オンプレミスの自己ホスティングの構成
自己ホスティングを使用し、デフォルトの CDN を使用しない場合は、次の手順に従って、すべての JavaScript エージェントファイルをホストするための独自の CDN を提供できます。
- [Controller Admin, ] から、次の場所に移動します。
theController Settingsページ. - 設定
eum.jsagent.cdn.host.http
とeum.jsagent.cdn.host.https
を見つけます。 - これらの 2 つの設定の値には
、JavaScript エージェントファイルがホストされている場所の URL を入力します。 ページに手動で挿入した HTML スニペットで、これらの URL が使用されていることを確認します。
次のステップ
JavaScript エージェントを構成したら、次のいずれかの方法でコードスニペットを挿入します。
これらの挿入方法の違いについては、「インジェクションタイプの概要」を参照してください。