このページでは、JavaScript エージェントを手動で挿入してブラウザアプリケーションをインストゥルメント化する方法について説明します。挿入前に JavaScript エージェントを設定するには、「JavaScript エージェントの構成」を参照してください。

JavaScript エージェントの手動での挿入

コントローラ UI では、JavaScript エージェントの設定、HTML スニペットの生成、そのスニペットの Web ページのヘッダーへの追加を実行できます。 

  1. コントローラ UI で、ブラウザアプリケーションに移動します。 
  2. 左側のナビゲーションメニューから [Configuration] > [ Configure JavaScript Agent] を選択します。
  3. JavaScript エージェントの構成を使用して無効にすることができます。
  4. HTML スニペットを保存してコピーします。
  5. Web ページのヘッダーに HTML スニペットを追加します。 

JavaScript エージェントの配置

JavaScript エージェントの推奨場所は、<head> のセクションの一番上です。adrum.js ファイルは、ページのロードが開始される時間をキャプチャします。すべてのブラウザで他のタイミングが計算される時間の基準として、この時間は測定されます。ただし、多くの最新のブラウザはナビゲーションタイミング API をサポートしています（このリストを参照）。これらのブラウザについては、API を使用してタイミングが取得されます。そのため、ページの他の場所に JavaScript エージェントを配置することも可能ですが、その場合は便利なタイミング情報を、これらの NavTime 対応ブラウザでのみ使用できます。 

同期スクリプトロードと非同期スクリプトロード

ダウンロードが完了すると、JavaScript エージェントが Ajax イベント、リソース、エラーなどのページデータのモニタリングを開始するため、adrum.js ファイルを同期的にロードすることが Splunk AppDynamics では推奨されています。（async 属性を使用して）初めて adrum.js が非同期でロードされた場合、JavaScript エージェントは必ずしもすべてのページデータをレポートしない場合があります。 

JavaScript エージェントの以前のバージョンの使用

エージェントの以前のバージョンは、次の場所にあります。ここで VERSION はアクセスが必要なバージョン番号（例：4.5.0）です。

http://cdn.appdynamics.com/adrum/adrum-VERSION.js
CODE
  • SaaS EUM クラウドを使用していて、adrum.js のホステッドバージョンが必要な場合、Splunk AppDynamics では adrum-latest.js バージョンの使用が推奨されています。ただし、任意のバージョンの JavaScript エージェントを使用できます。これは、現在展開されている SaaS EUM クラウドのバージョンと互換性があるためです。
  • オンプレミス EUM サーバーを使用していて、adrum.js のホステッドバージョンが必要な場合は、adrum.js のバージョンを EUM サーバーのバージョンと一致させる必要があります。
  • コントローラバージョンの場合、JavaScript エージェントバージョンは、同じバージョンまたは古いバージョンのコントローラバージョンと互換性があります。たとえば、JavaScript エージェント 20.6.0 はコントローラ 20.6.0 以下と互換性があります。 

手動インジェクションの確認

エージェントが挿入されると、コントローラは数分でページを検出して認識できるようになります。これは、データの表示を開始する前に行う必要があります。ただし、手動インジェクションを使用してページを構成していて、ロードを実行した後にしばらくの間ブラウザ RUM メトリックが表示されない場合は、Web ページをチェックして、ブラウザ RUM の JavaScript エージェントがページに存在することを確認します。存在しない場合は、スクリプトをもう一度挿入します。

2 回試してもブラウザ RUM メトリックが表示されず、プラットフォームで他のインジェクション方法が使用できる場合は、そのいずれかを試します。詳細については、「ブラウザ RUM のトラブルシューティング」を参照してください。