CrittercismConfig

This object is used to specify various configuration options for Workspace ONE Intelligence SDK. Once this object is setup, you can pass it to Crittercism.initialize. After Workspace ONE Intelligence SDK is initialized, changes to this object will have no affect.

Creating a Config

+ defaultConfig

Creates a new CrittercismConfig object with the default values for the above properties. You can modify the config values and pass this object into [Crittercism enableWithAppID:andConfig]

Objective-C

+ (CrittercismConfig *)defaultConfig

Swift

class func default() -> CrittercismConfig

Returns CrittercismConfig with default values.

Network Insights Configuration

enableServiceMonitoring Property

Determines whether Network Insights is enabled at all. If this flag is set to NO, then no instrumentation will be installed and the thread that sends Network Insights data will be disabled.

Default value: YES (enabled)

Objective-C

@property (nonatomic, assign) BOOL enableServiceMonitoring;

Swift

var enableServiceMonitoring: Bool

monitorNSURLConnection Property

Determines whether Network Insights should capture network performance information for network calls made through NSURLConnection.

Default value: YES

Objective-C

@property (nonatomic, assign) BOOL monitorNSURLConnection;

Swift

var monitorNSURLConnection: Bool

monitorNSURLSession Property

Determines whether Network Insights should capture network performance information for network calls made through NSURLSession.

Default value: YES

Objective-C

@property (nonatomic, assign) BOOL monitorNSURLSession;

Swift

var monitorNSURLSession: Bool

urlFilters Property

An array of CRFilter objects. These filters are used to make it so certain Network Insights data is not reported to Workspace ONE Intelligence, for example URLs that may contain sensitive information. These filters can also be used to prevent URL query parameters from being stripped out (by default all query parameters are removed before being sent to Workspace ONE Intelligence).

Objective-C

@property (nonatomic, strong) NSArray<CRFilter *> *urlFilters;

Swift

var urlFilters: Array<CRFilter>

Delay App Load Configuration

delaySendingAppLoad Property

Determines whether Workspace ONE Intelligence SDK should automatically send app load request or the app will decide when app load request should be sent by calling sendAppLoadData.

By default, Workspace ONE Intelligence SDK immediately reports an app load when Workspace ONE Intelligence SDK is initialized. The delay app load feature is most often used to delay counting an app load until after a user has passed a login screen.

Default value: NO (Workspace ONE Intelligence SDK will automatically send app load request)

Objective-C

@property (nonatomic, assign) BOOL delaySendingAppLoad;

Swift

var delaySendingAppLoad: Bool

Monitoring Web Views

Workspace ONE Intelligence has the capability to monitor network traffic generated by web views and JavaScript errors generated by WKWebViews.

Monitoring of WKWebView traffic is disabled by default because use of the WKWebView class has the side effect of calling the class initialize method, which creates a new thread to manage webviews.

Since Workspace ONE Intelligence cannot prevent these side effects from happening and many apps do not use webviews, Network Insights for webviews must be explicitly enabled.

Note

Monitoring Web Views must be enabled in Hybrid Apps in order for Workspace ONE Intelligence SDK API calls in the JavaScript code layer to communicate with the native code layer.

monitorUIWebView Property

Determine whether Network Insights should capture network performance information for network calls made through a UIWebView. Currently only page loads and page transitions are captured. Calls made via javascript are currently not captured.

UIWebView monitoring is disabled on tvOS.

Default value: NO

Objective-C

@property (nonatomic, assign) BOOL monitorUIWebView;

Swift

var monitorUIWebView: Bool

monitorWKWebView Property

Determine whether Network Insights should capture network performance information for network calls made through a WKWebView. Currently only page loads and page transitions are captured. Calls made via javascript are currently not captured.

WKWebView monitoring is disabled on tvOS.

Default value: NO

Objective-C

@property (nonatomic, assign) BOOL monitorWKWebView;

Swift

var monitorWKWebView: Bool

Send Data On Wifi Only

allowsCellularAccess Property

Determines whether the client will send data to Workspace ONE Intelligence while on a cellular network.

Default value: YES

Objective-C

@property(nonatomic) BOOL allowsCellularAccess;

Swift

var allowsCellularAccess: Bool

Deprecated Methods

delegate Property

This method has been deprecated. Please listen to CrittercismDidCrashOnLastLoadNotification

This object provides a callback that Workspace ONE Intelligence SDK will use to notify an app that the app crashed on the last load.

Objective-C

@property (nonatomic, strong, nullable) id<CrittercismDelegate> delegate;

Swift

var delegate: CrittercismDelegate?