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.

 

Comments

Hi,
In the "Disabling app usage monitoring" section
ApigeeMonitoringOptions *monitoringOptions = [[ApigeeMonitoringClient alloc]init];

This is wrong , the ApigeeMonitoringClient is allocated and assigned to ApigeeMonitoringOptions object.
Both objects should be same,right?

Yes, that's correct. This is an error in the docs. It should be:
ApigeeMonitoringOptions *monitoringOptions = [[ApigeeMonitoringOptions alloc] init];

Fixed in the content.

Add new comment

Provide your email address if you wish to be contacted offline about your comment.
We will not display your email address as part of your comment.

We'd love your feedback and perspective! Please be as specific as possible.
Type the characters you see in this picture. (verify using audio)

Type the characters you see in the picture above; if you can't read them, submit the form and a new image will be generated. Not case sensitive.