AppDynamics Application Intelligence Platform

3.9.x Documentation

PDFs

Learn by Watching

Doc Maps

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

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

Metrics are collected on your end users' experience in their Web browsers using a special JavaScript for agent for Web EUEM. 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 EUEM.

EUEM License

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

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

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

Accessing Web EUEM Configuration

  1. In the left navigation menu, click Configure -> Instrumentation.
  2. Click the End User Experience tab.

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

Web EUEM Prerequisites

To turn on Web EUEM functionality you need to:

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

Enable and Disable Web EUEM

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

Inject the JavaScript Agent for Web EUEM into Your Application Pages

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

The JavaScript agent for Web EUEM 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 EUEM.

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 EUEM Cloud aggregator, which performs EUEM 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. 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.

See Modify GlassFish JVM Options for more information about this utility.

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 EUEM Configurations

You can also configure:

Learn More