The MobileFirst Platform Operational Analytics Console is a web-based UI that is dedicated to the ongoing monitoring of the deployed applications, adapters, and servers.
- Introducing IBM MobileFirst Platform Operational Analytics
- Viewing the Analytics Dashboard - Configurations
- Capturing data
- Capturing data - Network Activities
- Capturing data - Notification Activities
- Capturing data - Server logs
- Capturing data - Client logs
- Analytics logs
- Sending data
- Creating a custom chart
Introducing IBM MobileFirst Platform Operational Analytics
MobileFirst Operational Analytics collects data about applications, adapters, devices, logs, and your own custom events to give a high-level view of the client interaction with the IBM MobileFirst Platform Server.
Starting with IBM MobileFirst Platform Foundation V7.0, MobileFirst Operational Analytics is delivered as an EAR file which contains two WAR files:
analytics-service.war. You can deploy the EAR file to the following supported application servers:
- WebSphere Application Server
In MobileFirst Studio, the two WAR files are installed and available by default in the embedded Liberty server.
Viewing the Analytics Dashboard - Configurations
wl.analytics.url property must be set to send data to the Analytics server and the
wl.analytics.console.url must be set to access the Analytics dashboard.
You can set these two properties in the
After the property is set, the Analytics Dashboard link appears in the MobileFirst Operations Console.
Click the Analytics Dashboard link to open up the dashboard in a new window.
Different types of analytics events are captured by the MobileFirst Operational Analytics server: network activities, notification activities, server logs, and client logs.
- Client interacting with the server
- Push notifications
- Server events
- Server stack traces
- Debug logs
- Custom events
- Network latency information
Capturing data - Network activities
When a network activity occurs, the event is captured automatically and forwarded to the MobileFirst Operational Analytics server.
- The following API call results in a session hit that is visualized on MobileFirst Operational Analytics:
- The following API call results in an adapter hit and a session hit that are visualized on the MobileFirst Operational Analytics dashboard:
Capturing data - Notification Activities
When a push notification occurs, the event is captured automatically and forwarded to the MobileFirst Operational Analytics server.
Capturing data - Server Logs
The log data that is generated by MobileFirst Server is automatically forwarded to the MobileFirst Operational Analytics server, where the data can be searched and downloaded.
To disable this behavior, set the
wl.analytics.logs.forward property to
Capturing data - Client Logs
You can instrument a MobileFirst application with client logs to record client debugging information and events.
You can use the following APIs to create client logs which are then forwarded to the MobileFirst Operational Analytics server, where they can be searched and downloaded.
Client-side logs are captured based on the logging level that is set on the client. If you want to create analytics logs that are always captured regardless of the logging level, you can use the
Logs that are captured by the client-side logging APIs and the
WL.Analytics APIs are sent to the server automatically upon a successful server connection or a successful adapter call.
You can disable this automatic behavior by using the following call:If you want to send this data more frequently, you can use the following API calls:
Custom charts are a new feature of MobileFirst Platform Operational Analytics 7.0 and later. By using custom charts, you can take data that is already collected, like device ID, device model, device OS, etc., or log your own custom data and create charts. To understand how to log and send data, see Analytics logs and Sending data.
- Bar Graph
- Flow Chart
- Line Graph
- Metric Group
- Pie Chart
Creating a custom chart
Creating a custom chart is simple. The following example walks you through creating a pie chart, based on the user pressing three buttons.
The messages that are logged to the Operational Analytics server in this example are hard-coded buttons. Those messages look like this:
To create a chart, follow these steps.
- Go to the Custom Charts tab and click Create Chart.
The following will appear.
As you fill out your information, more input fields are displayed.
- Enter a Chart Title
- Select Custom Data as the Event Type
- Select a Chart Type. This example uses a Pie Chart.
- Click on the Chart Definition tab.
- Select a Property. This example uses
- Click Save. The chart is saved under the Custom Charts tab in the main dashboard.
If you are using the latest interim fix of MobileFirst, you can set thresholds in alert definitions in the IBM MobileFirst™ Platform Operational Analytics Console to better monitor your activities.
You can configure thresholds, which if exceeded, trigger alerts to notify the MobileFirst Operational Analytics Console monitor. The triggered alerts can be visualized on the console, or the alerts can be handled by a custom webhook. This feature provides a proactive means of detecting client log errors, server log errors, extended periods of network latency, and authentication failures. Reactive thresholds and alerts keep you from having to sift through your data and set thresholds at a wide spectrum of granularity.
To navigate to the Alert's dashboard there is a button with a bell in the top right corner as indicated in the picture below. The button may have a number associated, like in the image below. This number represents the number of alerts that have gone off since the last time last time a user has marked that they were notified of the alerts.
The initial page to the Alert's dashboard is the Alert's log page. In the Alert's log page you can see previous alerts that you were alerted about. If an alert has not been marked as viewed, then you will see a red circle over the alert count. To mark this as viewed, just press on the red circle.
If you navigate to the 'Alert Management' tab, you can see the previous alerts that have been created. Here you can enable the alerts, copy the alerts for a starting point when creating a new alert, edit an existing alert, delete an existing alert, or create a new alert.
Creating an Alert
To create an alert, press the 'Create Alert' button under the 'Alert Management' tab in the Alert's dashboard. When creating an alert, the alert's information will populate as you are filling in information because not every alert will take the same values. Below you can see an alert with information already filled in.
MobileFirst Platform Foundation Analytics now has a simple migration tool for users who are on an earlier version of Operational Analytics than MobileFirst Platform Foundation 7.1.0. This feature is needed because some of the search mappings in previous versions of IBM MobileFirst Platform Foundation that are necessary to populate the Analytics console have been changed.
To run this search, go to the Administration tab on the left side of the console. After the administration console loads, click the Migration tab on the top tab bar. You can then see how many documents you have to migrate and the progress of the migration. You can perform a migration by pressing the Perform Migration button. After the migration process, all your data is migrated to IBM MobileFirst Platform Foundation 7.1.0 with all the correct mappings. You can see an example of the migration tab below.
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.