On this page:

自動 JavaScript エージェント インジェクションによるブラウザ インストゥルメンテーションを使用し、SAP Fiori、WebDynpro、WebGUI（SAPGUI for HTML）、および BSP（CRM WebUI など）アプリケーションのリアルユーザーモニタリング（RUM）を有効にします。

前提条件

ブラウザ インストゥルメンテーションの構成

ブラウザ インストゥルメンテーションは、SAP トランザクションコード /DVD/APPD_CUST を使用して [Instrumentation settings ] > [ Browser Instrumentation] からカスタマイズできます。

次の表に、[Instrumentation Settings] のフィールドと説明を示します。

フィールド説明
Hosting options

JavaScript エージェントファイルをホストする場所を決定します。「JavaScript エージェントの設定」を参照してください。

  • AppDynamics CDN: すべての JavaScript エージェントファイルはホスト cdn.appdynamics.com から取得されます。これはシンプルでテスト目的に便利なオプションです。

  • Self-Hosting：すべての JavaScript エージェントファイルをホストします。より詳細な制御が可能になり、実稼働に推奨されます。 

  • Shared Hosting：メインファイル adrum.js をホストします。非同期的に読み込まれるファイルは AppDynamics CDN から取得されます。JavaScript エージェントの最も重要なファイルを制御できます。JavaScript エージェント全体をホストするリソースがない、またはそうしないことが推奨される、小規模から中規模のビジネスに最適です。
  • Custom snippet：JavaScript インジェクションの完全なコードスニペットを入力できます。このホスティングオプションを使用すると、すべてのパラメータがコードスニペットで管理されます。
Agent Version

[AppDynamics CDN] ホスティングが選択されている場合に表示されます。デフォルト値は adrum-latest.js.

このフィールドは、デフォルト値が次である AppDynamics CDN 以外のホスティングオプションの場合は表示されません。 adrum.js.

Custom host

[Self-Hosting ] または [Shared Hosting] が選択されている場合に表示されます。

これは必須フィールドで、値に HTTP:// または HTTPS:// などのプレフィックスを含めることはできません。

XHR Exclusion Pattern

XHR コールをモニタリングから除外するための URL フィルタ。セミコロン（;）を区切り文字として使用し、.*foo.*; .*bar.* などの複数のパターンを入力します。

詳細については、「URL による XHR コールのフィルタリング」を参照してください。

API Key

この値は、ブラウザ RUM が設定されていると取得されます。

Cross domain correlation複数ドメイン間でのセッション相関を有効にするフラグ。詳細については、「複数ドメイン間でのセッション相関」を参照してください。
Inject at end of HEAD block

ABAP エージェントは、インストゥルメント化された Web ページの HEAD ブロックの先頭に JavaScript エージェントスニペットを挿入します。このフラグが設定されている場合、スニペットは HEAD ブロックの最後に挿入されます。 

このオプションは、トラブルシューティング用です。

UI5 Instrumentation activeJavaScript エージェントを使用して SAP Fiori（UI5）アプリケーションのインストゥルメンテーションを有効にするフラグ。
WebDynpro instrumentation activeJavaScript エージェントを使用して WebDynpro アプリケーションのインストゥルメンテーションを有効にするフラグ。
WebGUI instrumentation activeJavaScript エージェントを使用して WebGUI（SAPGUI for HTML）アプリケーションのインストゥルメンテーションを有効にするフラグ。
BSP instrumentation activeJavaScript エージェントを使用して BSP ページ（CRM WebUI もカバー）のインストゥルメンテーションを有効にするフラグ。
EUM correlation is activeブラウザ RUM モニタリングと SAP（C++ SDK）ビジネストランザクションの相関を有効にするフラグは、リリース 21.2.0 以降で使用できます。「制限事項」を参照してください。

カスタムコードスニペット

カスタム コード スニペット ホスティング オプションでは、オンプレミス EUM サーバーの指定など、より多くのオプションを使用できます。詳細については、「JavaScript エージェントの構成」を参照してください。

[Hosting Options] ドロップダウンメニューから [Custom snippet] を選択し、JavaScript エージェント インジェクションのカスタムスニペットを入力します。

制限事項

サポート制限事項
C++ SDK/HTTP SDK の関連付け
  • ブラウザ RUM モニタリングとバックエンドリアルタイム SAP（C++ SDK）ビジネストランザクションの相関は、ABAP エージェント 21.2.0 のみでベータモードで使用できます。
  • 相関ロジックは ABAP エージェント 21.5.0 で改善されました。最適な結果を得るには、コントローラが 21.6.0 以降で、JavaScript エージェントが 21.6.0 以降の最新の ABAP エージェントバージョンを使用することをお勧めします。
  • ブラウザ RUM 相関は、リアルタイム ビジネス トランザクション（BT コンテキストを使用）でのみ使用できます。
  • 再構築されたビジネストランザクション（BT コンテキストなし）では、ブラウザ RUM 相関はサポートされません。SAPGUI と WebGUI の両方に影響します。
SAP NetWeaver インストゥルメンテーション

ブラウザ インストゥルメンテーションは、SAP NetWeaver リリース 7.40 以降でサポートされています。

WebDynpro アプリケーション

Internet Explorer を介して開始された WebDynpro アプリケーションは互換モードで実行されるため、ソースコードをインストゥルメント化しようとすると、新しいバージョンの JavaScript エージェントが構文エラーで終了します。

互換性のある最新のバージョンは、JavaScript エージェント 4.5.7.1910 です。WebDynpro アプリケーションに Internet Explorer を使用する場合は、設定でこのバージョンを指定します。

Fiori Launchpad の既知の問題

XHR 要求モニタリングが有効になっていると、JavaScript エージェントによって一部の Fiori Launchpad ページが正しく読み込めない場合があります。すべての Fiori Launchpad ページが正しく読み込まれるようにするには、使用している JavaScript エージェントのバージョンに応じて、以下の回避策を実行します。

JavaScript エージェント 21.6.0 以降

JavaScript エージェントが 21.6.0 以降の場合、config.isAbapApp = true を渡す必要があります。

(function(config) {
        config.isAbapApp = true;
        }
CODE

ABAP エージェント 21.8.0 以降では、このパラメータはデフォルトのスニペットに自動的に追加されます。

JavaScript エージェント 21.5.0 以前

JavaScript エージェント 21.5.0 以前では、次の方法で XHR コールをモニタリングから除外する必要があります。

  • SAPUI5 設定の [XHR Exclusion Pattern] フィールドに値 .* を入力します。

Or

  • JavaScript カスタムスニペットに以下を追加します。
(function(xhr) {
        xhr.exclude = {
            urls: [{
 				pattern: ".*"
                }
            ]
        };
    })(config.xhr || (config.xhr = {}));
CODE

詳細については、「URL による XHR コールのフィルタリング」を参照してください。