This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

For manual injection, you download the JavaScript Agent and include it in the header of the web pages for which you want to collect Browser RUM data.

If your installation connects Browser RUM to a server-side application that is also instrumented, we recommend you also use assisted injection to add a footer to your pages. Manual injection gives the server-side agent the ability to write data only to the header of the page as it is being constructed by your web application. Server-side business transaction information is sometimes not available until after the header has already been written, so using a footer can ensure that the information is captured. See Getting Full Timing Data for Associated Business Transactions for more information.



Download and Include the Agent

You configure manual injection from the JavaScript Instrumentation tab of the Browser RUM configuration screen.

To use the same downloaded agent for multiple applications, or to use a cloud-hosted version of the main agent file, adrum.js, instead of downloading it, see Options in Using Manual Injection for the Browser RUM JavaScript Agent.

Access the manual injection panel

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

  2. From the left navigation menu, select Configuration. 

  3. Click the Web Javascript Instrumentation tab.

  4.  Scroll down to the Instrument your HTML pages with the JavaScript Agent panel.

Inject the JavaScript Agent for Browser Monitoring

  1. Click Download the JavaScript Agent.
  2. Click Save to File to save it.
    The name of the saved file should be "adrum.js".Save it where you save other assets, such as images and CSS files, for the page into which you are injecting.  If you have a single code base hosting multiple domains, you need to host adrum.js in each domain.
  3. To include the JavaScript Agent in your page, copy the line in the text field in the second step and paste it into the header, right after the <head> tag and any <meta> tags, of the pages that you want to monitor.  Making sure that the JavaScript Agent loads immediately improves timing accuracy.
    (info) If your page has <meta> tags, place them right after the <head> tag and then add the agent line.
    You will get Browser Monitoring metrics for all pages in which you include this line. If you later decide that you do not want metrics for the page, remove the line.
  4. Click Save in the configuration screen.

This inclusion is highly preferable, for convenience, accuracy, and maintenance, to copying the entire JavaScript agent into your web pages inline.

The JavaScript for Browser Monitoring Agent is named adrum.js. This script asynchronously invokes another script called adrum-ext.js, which performs most of the monitoring logic. The adrum-ext script is hosted on Amazon CDN, but you have the option of hosting it at another location. See Using a Local Version of the JavaScript Agent Extension for information about configuring this option.

(info) If your users are likely to be using IE8 and WIndows XP, hosting adrum-ext.js locally will help insure that https beacons can be sent to the EUM Cloud correctly. 

Watch the Video

For full-screen viewing, click Setting Up Browser RUM.