Knowledge Base

cancel
Showing results for 
Search instead for 
Did you mean: 

I created a new EUM app. Why is there no EUM data on the Controller?

Problem

Some users see no EUM data on their Controller after creating a new EUM application and instrumenting their web app with an EUM JavaScript Agent (Adrum).

 

Solution:

Review the checklist below to troubleshoot EUM data issues. Click on the section name below to jump to that section:

License Problems

Injection Problems

Browser RUM Metrics Not Reported

No EUM metric data

Pages Not Monitored (partial loss of browser request monitoring)

Connection Issues

 

License Problems

  1. No EUM Account License Key
    The EUM account license is separate from the Controller license. Although the license file includes the EUM license key, the EUM account license is provisioned separately. Controllers cannot share an EUM license key, but applications can. If you need an EUM license, call your AppDynamics sales representative or email salesops@appdynamics.com.
  2. Controller reporting "Your account is not currently licensed for End User Monitoring"
    Sometime we see license reporting accounts that do not have EUM accounts, even when the EUM license is correctly provisioned via a license on the Controller and EUM server. This is mostly due to communication issues where the Controller is never able to sync the EUM license from the EUM server and report, as we don’t have an EUM license on the License screen.

    1. Review the Controller’s server.log to see if there is a connection issue between the Controller and EUM server when the Controller trying to sync the EUM license. Some common issues are outlined here.
  3. Browser RUM Does Not Work in Production
    If you are running more than one Controller, each instance requires a unique license. You cannot use the same license on more than one Controller.
  4. Account not provisioned on EUM server
    When a new EUM license is issued, it needs to be provisioned on the EUM server and get synced on the Controller. Otherwise, the EUM will reject the Controller’s requests for metric download. To provision EUM licenses for each Controller account:
    1. Log in to your EUM Server.
    2. Change to the directory with the script for provisioning licenses: $> cd $EUM_HOME/eum-processor
    3. Provision each license, one at a time, on the EUM Server by running the following command: $> ./bin/provision-license.sh <P ATH_TO_EUM_LICENSE>

 

Injection Problems

You must inject the JavaScript Agent for Browser RUM into every page that you want to monitor.

 

  1. Verify the JavaScript Agent injection
    View the source of your web page. If you used automatic or assisted injection, you should see the script for the JavaScript Agent inline in the web page. When manual injection is used, you will see:  <script src="/path_to_adrum.js"/>. If you used manual injection, use the normal procedures that you use to verify other types of code changes in your web pages.

    1. To verify if automatic or assisted injection is enabled, see: Injection Problems
    2. Various caches (e.g. server page, CDN or browser caches) can prevent the page from being reloaded.

 

Browser RUM Metrics Not Reported 

  1. Check for Load
    Make sure there is load running on your app for the pages that you want to monitor for the selected period. When Browser RUM discovers a new page, iFrame, or Ajax call for the first time, data will not immediately display in the Controller UI. For details, see: Check for Load
  2. Confirm Browser RUM Is Enabled
    Make sure Browser RUM is enabled for the app: Enable and Disable Browser Monitoring
  3. Check Connectivity
    Make sure there is connectivity from the browser to the EUM Cloud. To verify connectivity, run this command from your browser: https://api.eum-appdynamics.com/eumaggregator/ping
    1. If you get a "ping" in the window, you should be able to connect to the EUM Cloud.
    2. If you are using IE on a Windows system, make sure the browser itself does not have a proxy (with authentication) set up. If it does, the test link may work but not the actual connection.
  4. Examine Beacons for Issues
    If beacons are not present or their status is invalid, verify your Browser RUM configuration. To examine your instrumented application, verify the following:
    1. The JavaScript Agent extension (adrum.ext) is loaded and its status is OK (200).
    2. The EUM beacon is sent as outlined here.
    3. For additional troubleshooting related to beacons, including length limitations, see: Examine Beacons
  5. Use the Web Browser’s Developer Tools to Examine Your Application
    Create a HAR file to confirm that the browser is downloading the expected resources for your web page. For instructions and example screenshots, see: Use Developer Tools to Examine Your Application.

 

No EUM metrics

  1. Connection issue between the Controller and EUM server
    The Controller polls the EUM server for metrics and crash reports every minute. If this communication is down, you will not see any EUM metrics on the account level. The whole EUM application will loose EUM metrics. Common communication issues are outlined here.
  2. Metric limits
    EUM monitoring for new requests can get dropped if one of these metric limits gets hit:
    1. metric.registration.limit The maximum number of metrics that can be registered for an account in the Controller. The default is 2 million.
    2. application.metric.registration.limitThe maximum number of metrics that can be registered for a business application in the Controller. The default is 1 million.
    3. appdynamics.controller.eum.otherMobile.metricsCount.limit - The maximum number of metrics that can be registered for web browser requests per application in the Controller. The default is 100000.
    4. appdynamics.controller.eum.otherWeb.metricsCount.limit - The maximum number of metrics that can be registered for mobile network requests per application in the Controller. The default is 100000. For additional instructions, see Should I alter the Metrics Count Limit in my EUM server?

 

Pages Not Monitored (partial loss of browser request monitoring)    

  1. Verify Pages Have Been Injected
    If only some web pages are not reporting data, verify that those pages have been injected with the JavaScript Agent: Verifying that the JavaScript Agent for Browser RUM was injected.
  2. Check Exclude Rules
    If the agent has been injected, the page may not be monitored due to custom exclude rules. Review and modify custom exclude rules following the steps and screenshots here: Check Exclude Rules
  3. Check Automatic Injection Configuration to see if certain pages were excluded
    If you used automatic injection, check your automatic injection configuration to see if the missing pages are enabled for injection: Check Automatic Injection Configuration

 

Connection Issues

Below are potential connection issues you may experience that are also related to licensing and EUM metric problems.

  1. Connect refused
    This indicates a network firewall or proxy issue. Please check with network admin.
  2. 401 Auth Error
    Check if Controller has the right access key to access EUM.
    1. Go to Admin.jsp > Controller settings
    2. Search for appdynamics.es.eum.key
    3. Make sure the value of property appdynamics.es.eum.key matches the property analytics.accountAccessKey in the <EUM_HOME>/bin/eum.properties file on the EUM server. 
  3. SSL error
    This happens when the Controller is trying to connect to a secured EUM server. If you see PKIX path building failed in the Controller server.log, the Controller trust store does not have the EUM client certificate and the validation failed. For steps to resolve this, see: Troubleshoot EUM Certificate Errors
  4. Controller-EUM incompatibility Issues
    An EUM server can not be of lesser version than the Controller. It should be the same version or higher. If necessary, upgrade your EUM server.

 

If you need additional assistance, contact AppDynamics support with the information outlined here.

 
Version history
Revision #:
9 of 9
Last update:
‎10-05-2018 09:28 AM
Updated by:
 
Labels (1)
0 Kudos