AppDynamics Application Intelligence Platform

3.8.x Documentation

PDFs

Videos

Release Notes

You must have an EUM license to access Web EUM. See EUM License.

End User Monitoring (EUM) must be enabled at the application level. Its UI is visible in the Controller GUI only if EUM is enabled. You can enable and then disable EUM if you decide not to use the feature. See Enable and Disable EUM.

AppDynamics collects metrics from your end users' experience in their Web browsers using a special JavaScript for agent for Web EUM. 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 Set Up Your Application for Web EUM.

EUM License

A special EUM license key is required. It covers both Web EUM and Mobile EUM.

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

Each JavaScript agent for Web EUM provides a certain number of page views per year. For information on how to examine your current page view usage, see Web EUM License.

Accessing Web EUM Configuration

  1. Select the application for which you wish to enable EUM.  

    To create a new application manually:

    1. Log into the controller with your AppDynamics credentials.
    2. In the left navigation pane click Applications.
    3. In the right pane Click + Create Application.
    4. Enter a name and optional description for the mobile application that you will instrument.
    5. Click OK.
  2. In the left navigation menu, click Configure -> Instrumentation.
  3. Click the End User Experience tab.

    Always remember to click Save in the EUM configuration screens whenever you make a change.

Web EUM Prerequisites

To turn on Web EUM functionality you need to:

  • enable End User Monitoring
  • inject the JavaScript agent into your application pages

Enable and Disable Web EUM

  1. At the top of the End User Experience configuration screen:
    • check Enable End User Experience Monitoring to enable Web EUM.
    • clear Enable End User Experience Monitoring to disable Web EUM.
       
  2. Click Save in the Web EUM configuration screen after you have made your change.

Inject the JavaScript Agent for Web EUM into Your Application Pages

The JavaScript agent for Web EUM collects EUM metrics. See Web EUM Metrics.

The JavaScript agent for Web EUM must be inserted into the headers of the pages for which you want to see these metrics. There are several ways to accomplish this. See Set Up Your Application for Web EUM.

Configure On-Prem Controller HTTP Proxy Settings (Optional)

If you have an on-premise Controller that uses an HTTP proxy host and port to communicate with the Internet, you need to add the following JVM options to the Controller configuration so that the Controller can communicate with the EUM Cloud aggregator, which performs EUM data processing:

  1. Set appdynamics.controller.http.proxyHost to the proxy host name or IP address. 
  2. Set appdynamics.controller.http.proxyPort to the proxy HTTP port.
  3. New in 3.8.2 If the proxy requires authentication, set credentials for the Controller using these options:  
    • Set appdynamics.controller.http.proxyUser to the user name that the Controller should use to authenticate to the proxy. 
    • Set appdynamics.controller.http.proxyPasswordFile to the plain text file that contains the password for the user. 

You can use the modifyJvmOptions utility to do this. Then stop and restart the app server.

For example, the following commands show how to modify the HTTP proxy options for a Controller on Linux, then stop and start the Controller's app server.

<Controller_installation_directory>/bin/modifyJvmOptions.sh add
-Dappdynamics.controller.http.proxyHost=myhost@-Dappdynamics.controller.http.proxyPort=8888
<Controller_installation_directory>/bin/controller.sh stop-appserver
<Controller_installation_directory>/bin/controller.sh start-appserver

Be sure to use the @ character to separate multiple options, as shown in the example. Alternatively, run the modifyJvmOptions utility once for each option to be added.   

The following commands modify the HTTP proxy options for a Controller that runs on Windows, then stops and starts the Controller's app server. The quotation marks enclosing the options string is required on Windows. Run the commands from an elevated command prompt, which you open by right-clicking on the Command Prompt icon in the Windows Start menu and choosing Run as administrator.

<Controller_installation_directory>\bin\modifyJvmOptions.bat add
"-Dappdynamics.controller.http.proxyHost=myhost@-Dappdynamics.controller.http.proxyPort=8888"
<Controller_installation_directory>\bin\controller.bat stop-appserver
<Controller_installation_directory>\bin\controller.bat start-appserver

If you need to modify these properties later, first run modifyJvmOptions with the delete command to delete the old setting, then use the add command to add the new ones. To delete the option, specify both the key and value of the key. See Modify GlassFish JVM Options for details.

To modify the Controller configuration file directly, edit the domain configuration file: 

<Controller_installation_directory>/appserver/glassfish/domains/domain1/config/domain.xml

Add the following JVM option to the existing java-config element:  

<jvm-options>
     -Dappdynamics.controller.http.proxyHost=myhost -Dappdynamics.controller.http.proxyPort=8888
</jvm-options>

 

Additional Web EUM Configurations

You can also configure:

Learn More