AppDynamics Application Intelligence Platform

3.9.x Documentation


Learn by Watching

Doc Maps

Skip to end of metadata
Go to start of metadata

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

If your installation connects Web EUEM 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.

Watch a quick video overview of the manual injection process:

Direct link:

Download and Include the Agent

You configure manual injection from the JavaScript Instrumentation tab of the Web EUEM 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 EUEM JavaScript Agent.

To access the manual injection panel

1. In the left navigation menu, click Configure -> Instrumentation.

2. Click the End User Experience tab.

3. Click the JavaScript Instrumentation subtab if it is not already selected.

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

To inject the JavaScript Agent for Web EUEM

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, 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 for EUEM 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 EUEM 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 EUEM Agent is named adrum.js. This script asynchronously invokes another script called adrum-ext, which performs most of the EUEM logic. The adrum-ext script is hosted on Amazon CDN, but you have the option of hosting it at another location. See Alternate Location for the JavaScript for EUEM Agent for information about configuring this option.

Learn More