AppDynamics Application Intelligence Platform

3.9.x Documentation


Learn by Watching

Doc Maps

Skip to end of metadata
Go to start of metadata
You set up and configure Mobile EUEM in two areas:
  • Your AppDynamics Controller
  • Your iOS and/or Android application

To prepare Mobile EUEM you need to make changes in both these areas in a particular order.

You need to do the following:

  1. Check your prerequisites
  2. Review Controller capacity
  3. Evaluate your mobile application
  4. Enable Mobile EUEM on your Controller
  5. Instrument and verify your app
  6. Configure network request naming and thresholds

Check Your Prerequisites

Before you can use AppDynamics to monitor your mobile application you need to make sure you have the following prerequisites:

  • An AppDynamics account, with access to an AppDynamics controller
  • A Mobile EUEM LIcense.  See Mobile EUEM Licenses.
  • Access to your mobile application source code

Review Your Controller Capacity

If you use an on-premise Controller and plan to monitor mobile applications, assess your Controller's capacity to accommodate the increase in the number of metrics that Mobile EUEM will generate. The number of individual metric data points generated depends on the level of activity of your mobile applications. As a rough guide the use of Mobile EUEM can increase the number of metric data points by as much as 15 to 25K per instrumented application, if your applications are heavily accessed by mobile users. The actual number depends on how many network requests your applications receive.

(info) The number of separate EUEM metric names saved in the Controller database can be larger than the kinds of individual data points saved.  For example a metric name for a metric for iOS 5 might still be in the database even if all your users have migrated away from iOS 5.  So the metric name would no longer have an impact on resource utilization, but it would count against the default limit in the Controller for metric names per application.  The default limit for names is 200,000 for Web EUEM and 100,000 for Mobile EUEM.

For more information about Controller sizing see Hardware Requirements per Performance Profile

Evaluate Your Mobile Application

Out of the box, Mobile EUEM can monitor your application in two ways: network requests and crash reporting.

If you want to collect information on network requests, your application must make HTTP calls using specific classes:

  • An iOS application must use NSURLConnection to generate network requests.
  • An Android application must use HttpClient or URLConnection to generate network requests.
Even if your application does not generate network requests, or if you do not want to monitor that activity, you can use AppDynamics purely to monitor crashes. You can also extend the mobile agents using the SDK to collect other data, like how your application is functioning internally.  See Customize Your iOS Mobile Instrumentation and Customize Your Android Mobile Instrumentation for more information.

Enable Mobile EUEM on Your Controller

Mobile EUEM is not enabled on your Controller by default and until it is turned on, the Controller UI does not display Mobile EUEM functionality.  

How you enable Mobile EUEM depends on how you are going to use it:

  • To monitor your mobile application's interaction with an existing server-side application
  • To monitor your mobile application with no server-side interaction.

(info) Your Controller must have a Mobile EUEM license before you can enable the Mobile EUEM functionality.

Enable by Connecting to an Existing Server-Side Application

If you want to monitor your mobile application in the context of an existing instrumented server-side application:

  1. In the left navigation panel of the Controller UI, click <your application>->Configure->Instrumentation.
  2. Select the End User Experience tab.
  3. Check the Enable Mobile checkbox.  If you do not see the checkbox, make sure you have applied your Mobile EUEM license to your Controller.

Enable without Connection to an Existing Server-Side Application

If your application does not interact with a server-side application or if you do not want to correlate the activity of your mobile app with any server-side application with which it may interact, you need to create a new "application" manually in the Controller. The application serves as a container for the information that the Controller is collecting.

  1. Log into the Controller with your normal AppDynamics credentials.
  2. In the left navigation bar click Applications.
  3. At the top of the central screen, click + Create Application.

  4. Enter a name and description for the application in the popup.

  5. Click OK.
  6. Select this application and follow the instructions here.

Disable Mobile EUEM on Your Controller

To disable Mobile EUEM, uncheck the Enable Mobile check box.

Instrument and Verify Your App

The method you follow to instrument your app depends on your platform:

Configure Network Request Naming and Thresholds

You can customize how you want the Controller to name your application's requests and what performance thresholds you want to be in effect.  See Configure Mobile Network Request Naming and Thresholds.