このページでは、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 ファイルを同期的にロードすることを推奨します。(async 属性を使用して)初めて adrum.js が非同期でロードされた場合、JavaScript エージェントは必ずしもすべてのページデータをレポートしない場合があります。 

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

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

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

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

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

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