Was this Helpful?

Apigee App Monitoring lets developers dig into the “what” and “where” of an application error or performance glitch by providing tools to view and analyze app usage metrics, allowing them to better isolate and fix the source of a problem. For example, you can compare the number of active sessions and users for your app over time, or view how long (on average) users are using your application.

Enabling app usage monitoring

Apigee App Monitoring automatically starts monitoring app usage data when you initialize the App Services SDK for iOS, Android and Javascript. For more information on installing the App Services SDK in your app, see the following:

Viewing app usage data

In the App Services admin portal, you can track trends visually in graphs and drill down to see in-depth data. With this information, you can then diagnose the root cause of an error or eliminate performance bottlenecks to improve the user experience of your app.

To display app usage data for your app, select 'Monitoring' in the main menu of the App Services admin portal, then select 'App Usage'. The following usage data for your app will be displayed:

  • A graph that plots session data for given points in time during a specified time period.
  • Metrics for carious categories of session data over the time period.
  • A table that lists the raw session data over the time period.
Network performance view What it displays
Overview Total app usage for all carriers, network types, platforms, and OS versions.
By App Versions Data for each version number of your app.
By Config Overrides Data by App Services configuration override (AB testing).
By Platforms Data by device platform, such as iOS and Android.
By OS Versions Data by the OS version being run on the device.
By Device Model Data by the model of device used to access your app.

Displaying a time comparison

You can also display a view that compares app usage data for the currently selected time period with the same period yesterday or last week. This is useful for identifying usage types that are changing over time.

To view a time comparison, click the 'Compare last week' or 'Compare yesterday' button above the graph.

Disabling app usage monitoring

To disable app usage monitoring, go to 'Configure' > 'Default Configs' in the App Services admin portal, then deselect the 'Enable Device Data Capture' checkbox.

Alternately, you can disable app usage monitoring programmatically by following the steps below.

Do the following when you initialize the ApigeeClient class in AppDelegate.m:

  1. Instantiate ApigeeMonitoringOptions and set monitoringEnabled:NO:

    ApigeeMonitoringOptions *monitoringOptions = [[ApigeeMonitoringOptions alloc]init];
    monitoringOptions.monitoringEnabled = NO;
    				
  2. Send monitoringOptions as the value of the options parameter when you initialize the ApigeeClient class:

    		
    appDelegate.apigeeClient = [[ApigeeClient alloc]
                                initWithOrganizationId:orgName
                                applicationId:appName
                                options:monitoringOptions];
    				

For more information on initializing the ApigeeClient class, see Installing the Apigee SDK for iOS.

Do the following when you initialize the ApigeeClient class:

  1. Instantiate MonitoringOptions and set the monitoringEnabled property to false:

    MonitoringOptiions monitoringOptions = new MonitoringOptions();
    monitoringOptions.setMonitoringEnabled(false);
    				
  2. Pass monitoringOptions to the ApigeeClient class when you instantiate it:

    ApigeeClient apigeeClient = new ApigeeClient(ORGNAME,APPNAME,monitoringOptions,this.getBaseContext());

For more information on initializing the ApigeeClient class, see Installing the Apigee SDK for Android.

Do the following when you initialize the Apigee.Client class:

Note than proceeding with this step will disable all Apigee App Monitoring functionality in your app, including app usage, network, crash and error monitoring:

Set disableAnalytics:true when you initialize Apigee.Client:

var client_creds = {
	orgName:'your-org',
	appName:'your-app',
	disableAnalytics:true
}

dataClient = new Apigee.Client(client_creds);			 
		 

For more information on initializing the Apigee.Client class, see Installing the Apigee SDK for JavaScript.

 

Help or comments?

  • Something's not working: See Apigee Support
  • Something's wrong with the docs: Click Send Feedback in the lower right.
    (Incorrect? Unclear? Broken link? Typo?)