On this page：

Related pages：

手動インジェクションの場合は、JavaScript エージェント ホスティング オプションのいずれかを使用し、JavaScript のスニペットを、ブラウザ RUM データを収集する Web ページのヘッダーに手動でコピーします。

手順は JavaScript ホスティングオプションによって若干異なるため、次の手順は JavaScript ホスティングオプションごとにまとめられています。ニーズに最も適したオプションについては、「JavaScript エージェント ホスティング オプション」を参照してください。

[Configuration] パネルへのアクセス

  1. 対象のブラウザアプリケーションを開きます。

  2. 左のナビゲーションメニューから [Configuration] > [ Configure JavaScript Agent] を選択します。

JavaScript エージェントのクラウド ホスト バージョンを使用する

  1. JavaScript ホスティングオプションで、次を選択します。 AppDynamics hosts all JavaScript agent files from cdn.appdynamics.com. 

  2. [Advanced] セクション：

  3. [Save Config & Generate HTML Snippet] をクリック。

  4. HTML スニペットをコピーして、モニタ対象のページのヘッダーに貼り付けます。貼り付ける位置は <head> タグとすべての <meta> タグの直後です。この HTML スニペットの位置によって、JavaScript エージェントがすぐにロードされ、タイミングの精度が向上します。


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

エージェントの以前のバージョンは、次の場所にあります。ここで VERSION はアクセスが必要なバージョン番号（例：4.5.0.0）です。4.5 より前のバージョンの場合は、サポートに連絡してください。

http://cdn.appdynamics.com/adrum/adrum-VERSION.js

SaaS EUM クラウドを使用していて、adrum.js のホステッドバージョンが必要な場合は、adrum-latest.js バージョンを使用します。オンプレミス EUM サーバを使用していて、adrum.js のホステッドバージョンが必要な場合は、そのバージョンを EUM サーバのバージョンと一致させる必要があります。

JavaScript エージェントのホスティング

  1. JavaScript ホスティングオプションで、次を選択します。I will host all the JavaScript agent files.

  2. [Download] をクリックして、JavaScript エージェントをダウンロードします。

  3. JavaScript エージェントファイルがあるディレクトリをコピーするか移動して、指定したダウンロード場所に配置します。たとえば、ホスト URL を myhost.com に構成した場合は、ディレクトリ adum をそのホストのサーバの Web ルートに移動します。
  4. [Specify the URLs where the files can be referenced:] の HTTP と HTTPS の両方にホストへの URL を入力します。URL にファイルパスまたはファイル名を含めないでください。

  5. [Advanced] セクションで、次の項目を決定します。

  6. [Save Config & Generate HTML Snippet] をクリックします。

  7. HTML スニペットをコピーして、モニタ対象のページのヘッダーに貼り付けます。貼り付ける位置は <head> タグとすべての <meta> タグの直後です。 

  8. スクリプトの src 属性が adrum.js のファイルパスまたは URL パスを指すように HTML スニペットを変更します。

オンプレミスの自己ホスティングの構成

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

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

  4. ページに手動で挿入した HTML スニペットで、これらの URL が使用されていることを確認します。

JavaScript エージェント拡張のみのホスティング

  1. JavaScript ホスティングオプションで、[I will host the main adrum-[version].js, but all other files should be loaded from cdn.appdynamics.com] を選択します。

  2. ファイル adrum.js（JavaScript エージェントファイルの 1 つ）をダウンロードする場合は、[Download] をクリックします。

  3. JavaScript エージェント拡張ファイルをコピーするか移動して、指定したダウンロード場所に配置します。たとえば、ホスト URL を myhost.com に構成した場合は、ファイル adrum-ext.js をそのホストのサーバの Web ルートに移動します。
  4. [Specify the URLs where the files can be referenced:] の HTTP と HTTPS の両方にホストへの URL を入力します。URL にファイルパスまたはファイル名を含めないでください。

  5. [Advanced] セクションで、次の項目を決定します。

  6. Save Config & Generate HTML Snippet をクリックします。

  7. HTML スニペットをコピーして、モニタ対象のページのヘッダーに貼り付けます。貼り付ける位置は <head> タグとすべての <meta> タグの直後です。 

  8. HTML スニペットが adrum.js のファイルパスまたは URL パスを指すように変更します。

オンプレミスの共有ホスティングの構成

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

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

  4. ページに手動で挿入した HTML スニペットで、これらの URL が使用されていることを確認します。

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

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

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

JavaScript エージェントの配置

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