Related pages:

For manual injection, use any of the JavaScript Agent hosting options and then manually copy a snippet of JavaScript into the header of the web pages for which you want to collect Browser RUM data.

Because the steps are slightly different depending on the JavaScript hosting option, the instructions below are organized by the JavaScript hosting option. See JavaScript Agent Hosting Options to learn what option best fits your needs.

Access Configuration Panel

  1. Open the browser application in which you are interested.

  2. From the left navigation menu, select Configuration > Configure JavaScript Agent.

Use a Cloud Hosted Version of the JavaScript Agent

  1. For the JavaScript hosting option, select AppDynamics hosts all JavaScript agent files from cdn.appdynamics.com. 

  2. For the Advanced section:

  3.  Click Save Config & Generate HTML Snippet.

  4. Copy the HTML snippet and paste it into the header of the pages that you want to monitor, right after the <head> tag and any <meta> tags. This HTML snippet location ensures that the JavaScript Agent loads immediately, which improves timing accuracy.


Using Previous Versions of the JavaScript Agent

Previous versions of the agent can be found at the following location, where VERSION is the version number (for example, 4.5.0.0) you want to access.

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

Use the adrum-latest.js version if you are using a SaaS EUM Cloud and want a hosted version of adrum.js. If you are using an on-prem EUM Server and want to use a hosted version of adrum.js, you need to match the version to the version of your EUM Server.

Host the JavaScript Agent

  1. For the JavaScript hosting option, select I will host all the JavaScript agent files.

  2. Click Download to download the JavaScript Agent.

  3. Copy or move the directory holding the JavaScript Agent files to the download location you specified. For example, if you configured the host URL to be myhost.com, move the directory adum to the web root of the server of that host.
  4. Under Specify the URLs where the files can be referenced:, enter the URL to your host for both HTTP and HTTPS. Do not include the file path or file name in the URL.

  5. For the Advanced section, determine if you want to:

  6.  Click Save Config & Generate HTML Snippet.

  7. Copy the HTML snippet and paste it into the header, right after the <head> tag and any <meta> tags of the pages that you want to monitor. 

  8. Modify the HTML snippet so that script src attribute points to where the file path or URL path of adrum.js.

Configure Self-Hosting for On-Premises

If you are self-hosting and don't want to use the default CDN, you can follow these instructions to provide your own CDN for hosting all of the JavaScript Agent files:

  1. From the Controller Admin, navigate to the Controller Settings page.
  2. Find the settings eum.jsagent.cdn.host.http and eum.jsagent.cdn.host.https.
  3. For the values of those two settings, enter the URLs to where the JavaScript Agent files are being hosted.

  4. Confirm that these URLs are used in the HTML snippet that you manually inject in the page.

Only Host the JavaScript Agent Extension

  1. For the JavaScript hosting option, select I will host the main adrum-[version].js, but all other files should be loaded from cdn.appdynamics.com.

  2. Click Download to download the file adrum.js, which is one of the JavaScript Agent files.

  3. Copy or move the JavaScript Agent extension file to the download location you specified. For example, if you configured the host URL to be myhost.com, move the file adrum-ext.js to the web root of the server of that host.
  4. Under Specify the URLs where the files can be referenced:, enter the URL to your host for both HTTP and HTTPS. Do not include the file path or file name in the URL.

  5. For the Advanced section, determine if you want to:

  6. Click Save Config & Generate HTML Snippet.

  7. Copy the HTML snippet and paste it into the header, right after the <head> tag and any <meta> tags of the pages that you want to monitor. 

  8. Modify the HTML snippet so that it points to the file path or URL path of adrum.js.

Configure Shared-Hosting for On-Premises

If you are using shared-hosting and don't want to use the default CDN, you can follow these instructions to provide your own CDN for just hosting the main JavaScript Agent file (adrum-[version].js):

  1. From the Controller Admin, navigate to the Controller Settings page.
  2. Find the settings eum.jsagent.cdn.host.http and eum.jsagent.cdn.host.https.
  3. For the values of those two settings, enter the URLs to where the JavaScript Agent files are being hosted.

  4. Confirm that these URLs are used in the HTML snippet that you manually inject in the page.

Verify Manual Injection

Once the agent is injected, it can take the AppDynamic controller a few minutes to discover and recognize the page, which must happen before data will begin to appear. If, however, you have configured your page using manual injection and are not seeing Browser RUM metrics after running load for a while, check the web page to confirm that the JavaScript Agent for Browser RUM is present in the page. If it is not, try injecting the script again.

If after two attempts you still do not see Browser RUM metrics, try one of the other injection schemes if they are available for your platform. See Troubleshoot Browser RUM for more troubleshooting information.

JavaScript Agent Placement

The recommended location for the JavaScript Agent is at the top of the <head> section. This is because one of the most important things that adrum.js does is capture the time as the page begins to load, and it is measured against the time that other timings are calculated, for all browsers. Many—but not all—modern browsers, however, support the Navigation Timing API (see this list), and for these browsers, timings can be acquired via the API. So locating the JavaScript Agent somewhere else on the page is possible, but useful timing information, in that case, is only available for those NavTime capable browsers.