Integrate with iOS

This topic describes how to configure performance monitoring instrumentation on the client for features such as network monitoring, H5 performance monitoring, page load monitoring, startup speed monitoring, and Mini Program monitoring.

Prerequisites

• The mPaaS baseline version is 10.1.68.44 or later. If you are using an earlier version, you must upgrade it. For more information, see mPaaS 10.1.68 upgrade guide.

• Ensure that you have integrated the Mobile Analytics component. For more information, see Integrate the Mobile Analytics service.

• Ensure that the mobile gateway component is connected. For more information, see Mobile Gateway Service.

• To use the H5 performance monitoring feature, you must integrate the H5 container. For more information, see Integrate with the H5 container.

• To use the Mini Program performance monitoring feature, you must integrate the Mini Program component. For more information, see Integrate with Mini Program.

Network monitoring

Enable network monitoring

You can manually enable APM network performance monitoring instrumentation in your project code. During app startup, call the following code to enable network performance monitoring.

#import <MPMasAdapter/MPAnalysisHelper.h>

[MPAnalysisHelper startAPMNetMonitor];

mPaaS RPC network monitoring instrumentation

After you enable APM network monitoring, the built-in mPaaS network framework automatically performs instrumentation for mPaaS RPC. You do not need to add manual instrumentation to your code.

Custom business network monitoring instrumentation

If you use a network communication method other than mPaaS RPC and want to monitor its network quality, you must enable APM network monitoring during app startup. You must also add manual instrumentation for your custom network calls.

Call the following code for instrumentation:

#import <MPMasAdapter/MPRemoteLoggingInterface.h>

NSDictionary *param = @{
                @"totalRequestTimeInterval": @(totalRequestTime),
                @"dnsTimeInterval": @(dnsTime),
                @"tcpTimeInterval": @(tcpTime),
                @"sslTimeInterval": @(sslTime),
                @"firstPackageTimeInterval": @(firstPackageTime),
                @"transportTimeInterval": @(transportTime),
                @"downloadAverageSpeed": @(downloadAverageSpeed),
                @"httpStatusCode": @(httpStatusCode),
                @"rpcStatusCode": rpcStatusCode,
                @"operationType": operationType,
                @"clientIP": clientIP,
                @"gwIP": gwIP,
                @"traceId": traceId
            };
[MPRemoteLoggingInterface writeAPMNetLog:param];

The input parameters are as follows:

H5 performance monitoring

The mPaaS H5 container automatically performs instrumentation for H5 performance monitoring. You only need to integrate the H5 container. No manual instrumentation is required.

Page load monitoring

The mPaaS native page automated instrumentation SDK performs instrumentation for native page load times. After you integrate the mobile analysis component, no manual instrumentation is required.

// globalMonitorStartUpTime is a predefined variable. You can use it after you import the <mPaas/MPaaS+MonitorStartUpTime.h> header file.
double time = CFAbsoluteTimeGetCurrent() - globalMonitorStartUpTime;
[ [NSNotificationCenter defaultCenter] postNotificationName:@"APMonitor_Startup_Cost_Time" object:nil userInfo:@{@"CostTimeOnUserFeel": [NSString stringWithFormat:@"%f", time]}];

#import <MPMasAdapter/MPAnalysisHelper.h>

//record the time interval used for the app startup
NSTimeInterval time = CFAbsoluteTimeGetCurrent() - __start_timestamp;
[[MPAnalysisHelper sharedInstance] writeLogForStartupWithTime:time];

#import <MPMasAdapter/MPAnalysisHelper.h>
/**
 * Enables or disables crash disaster recovery. This feature is enabled by default.
 */
+ (void)enableDisasterRecovery:(BOOL)enable;

    #import "PerformanceHelper.h"
    #import <MPAnalysis/MPAnalysisHelper.h>

    static NSTimeInterval __start_timestamp = 0;

    @implementation PerformanceHelper

    + (void)load
    {
        __start_timestamp = CFAbsoluteTimeGetCurrent();
    }

    + (void)performanceMonitor
    {
        //start performance monitor

       [MPAnalysisHelper setLagMonitorPercent: 100]; // Enable monitoring for 100% of devices. This must be set before you call startPerformanceMonitor.
        [MPAnalysisHelper startPerformanceMonitor];

        //record the time interval used for the app startup
        NSTimeInterval time = CFAbsoluteTimeGetCurrent() - __start_timestamp;
        [[MPAnalysisHelper sharedInstance] writeLogForStartupWithTime:time];
    }

    @end

Enable Mini Program monitoring

After you integrate the Mini Program component, the component automatically reports performance monitoring data. No manual instrumentation is required.