Skip to end of metadata
Go to start of metadata

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

To increase the success rate of correlating business transaction times with EUM data 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. 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 Web EUM 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 EUM 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 AppDynamics JavaScript Agent panel.

To inject the JavaScript Agent for Web EUM

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 EUM 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, of the pages that you want to monitor.
You will get EUM 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 EUM Agent is named adrum.js. This script asynchronously invokes another script called adrum-ext, which performs most of the EUM 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 EUM Agent for information about configuring this option.

Learn More

  • No labels