Troubleshooting PMF Analytics

Check the following possibilities.

• Verify that your apps are set to point to the PMF, which forwards the logs to the PMF Analytics Server. Ensure that the following values are set in the mfpclient.plist (iOS), mfpclient.properties (Android), or config.xml (Cordova) files.

  protocol = http or https
  host = the IP address of your PMF
  port = the HTTP port that is set in the server.xml file for reporting analytics
  wlServerContext = by default "/mfp/"

• Ensure that your PMF is pointing to your PMF Analytics Server.

  /analytics-service
  /analytics

• Check that you are calling the send method.
  • iOS:
    • Objective-C: [[WLAnalytics sharedInstance] send];
    • Swift: WLAnalytics.sharedInstance().send()
    • Android: WLAnalytics.send();
    • Cordova: WL.Analytics.send();
    • Web: ibmmfpfanalytics.send();

The crash logs must be sent to the server once the app is again running. Verify that your apps are sending logs after a crash. To be safe, send logs on app start-up to ensure that any previously unsent information is reported.

Configure your apps to collect analytics on the Network device event.

ibmmfpfanalytics.logger.config({analyticsCapture: true});

• For cross-platform apps that use Cordova, follow the iOS or Android guides, as the configurations are the same as for native apps.
• To enable the capture of network analytic data in iOS, add the following code in your Application Delegate application:didFinishLaunchingWithOptions method.
  Objective-C

  WLAnalytics *analytics = [WLAnalytics sharedInstance];
  [analytics addDeviceEventListener:NETWORK];

  Swift

  WLAnalytics.sharedInstance()
  WLAnalytics.sharedInstance().addDeviceEventListener(NETWORK)

• To enable the capture of network analytic data in Android, add the following code in your Application subclass onCreate method.
  Java

  WLAnalytics.init(this);
  WLAnalytics.addDeviceEventListener(DeviceEvent.NETWORK);

Configure your apps to collect analytics using the Lifecycle device event listener.

• For cross-platform apps that use Cordova, follow the iOS or Android guides, as the configurations are the same as for native apps.
• To enable the capture of network analytic data in iOS, add the following code in your Application Delegate application:didFinishLaunchingWithOptions method.
  
  Objective-C

  WLAnalytics *analytics = [WLAnalytics sharedInstance];
  [analytics addDeviceEventListener:LIFECYCLE];

  Swift

  WLAnalytics.sharedInstance()
  WLAnalytics.sharedInstance().addDeviceEventListener(LIFECYCLE)

• To enable the capture of network analytic data in Android, add the following code in your Application subclass onCreate method.
  Java

  WLAnalytics.init(this);
  WLAnalytics.addDeviceEventListener(DeviceEvent.LIFECYCLE);

If PMF Analytics is deployed on WebSphere Liberty versions prior to 8.5.5.6 and if multiple users are accessing the console, the console freezes or stops responding to any further user requests.

• This situation occurs because WebSphere Liberty runs out of Executor threads to service the requests. This leads to a dead lock situation.
• The default number of Liberty core threads is the number of hardware threads.
• To resolve this issue, configure the number of threads in the Liberty executor threads parameter to a value greater than the default.
  Add the following configuration to Liberty's server.xml:
  

  <executor name="LargeThreadPool" id="default" coreThreads="80" maxThreads="80" keepAlive="60s" stealPolicy="STRICT" rejectedWorkPolicy="CALLER_RUNS" />

• These tuning settings are generally not required in case of Websphere Liberty 8.5.5.6.