Set Up and Access Browser RUM

On this page:

Related pages:

You must have an EUM account and a Browser RUM license to access Browser RUM. See EUM Account.

EUM must be enabled through the Controller UI. You can enable and then disable EUM if you decide not to use the feature. See Enable and Disable EUM.

Metrics are collected on your end users' experience in their Web browsers using a special JavaScript agent for Browser RUM. Your web application must be configured to insert this agent into the web pages it serves in order for them to monitored. This process is called injection. See Configure the JavaScript Agent.

EUM Account

A special EUM account is required. An EUM account is created when you have a license for any of Browser RUM, Browser Synthetic, or Mobile RUM. There is an account license key associated with this account.

For on-premises customers, the account license key is set up within the Controller license file. If you added EUM after your initial installation, you may need to upload and install the new Controller license file. If you are a SaaS customer, the EUM license is set up in the SaaS Controller for you.

Each Browser RUM license provides a certain number of page views per year. For information on how to examine your current page view usage, see Browser RUM Licenses.

Access Browser Monitoring Configuration

Your data is displayed in the Controller UI in the context of an EUM application, which can be any name you choose. An EUM application name is associated with an EUM App Key, which identifies data coming into the Controller.

If you do not yet have an EUM application, click the User Experience tab, the Browser Apps tab, and the +Add button. You can create an application name either by using the Getting Started Wizard or by simply choosing an application name.
Open the EUM application in which you are interested in by double-clicking on the application name in the Browser Apps list.
In the left navigation bar of the application UI, click Configuration.

Browser RUM Prerequisites

To turn on Browser RUM, you need to:

enable Browser Monitoring
inject the JavaScript Agent into your application pages

Enable and Disable Browser RUM

At the top of the Configuration > Instrumentation > page, switch the Browser Monitoring toggle button to on:

To disable Browser RUM, toggle the switch to OFF.

Inject the JavaScript Agent for Browser RUM into Your Application Pages

The JavaScript Agent for Browser RUM collects Browser RUM metrics. See Browser RUM Metrics for more detail.

The JavaScript Agent for Browser RUM must be inserted into the headers of the pages for which you want to see these metrics. This process is called injection. There are several ways to accomplish this. See Configure the JavaScript Agent.

External Access Locations

Browser RUM is made up of several components, which, in various configurations, can either be located on the Internet or hosted inside your own data center/network. On-premises access points are configured at installation or through the UI. But if your installation requires access to any of these components on the Internet, the following is a list of the locations where the various components can be accessed. You need to make sure the appropriate URLs are accessible from your network.

Browsers download the JavaScript Agent extension. On the Internet, it is available from cdn.appdynamics.com.
The JavaScript Agent sends its data from the browser to the EUM Cloud. On the Internet, the browser sends its beacons to col.eum-appdynamics.com.
The EUM Cloud sends analytics data to the Events Service. On the Internet, the EUM Cloud sends its data to analytics.api.appdynamics.com:443.
The Controller fetches data from the EUM Cloud. On the Internet, the Controller fetches data from api.eum-appdynamics.com:443.
The Controller queries the Events Service. On the Internet, the Controller queries analytics.api.appdynamics.com:443.

Additional Browser RUM Configurations

You can also configure: