Before each device is able to send data to an application server, it needs to communicate with the mobile network to ensure that the data is allowed to be sent over the network. This communication happens through signaling events which are usually hidden to the application. The EMnify DataStreamer makes this connectivity metadata and device data usage available in real-time in your Keen.io account for detailed insights on the consumption and state of your devices.
In this guide we will be building an example dashboard with several relevant widgets to troubleshoot connectivity. The following queries will be created and will have associated charts added to our dashboard:
Newly-created data streams are immediately active and should show a green Running status indicating a 200 HTTP response code when correctly configured.
If the configuration is invalid, a warning message will be displayed indicating incorrect configuration.
To verify that the stream is bring processed correctly in Keen.io, navigate to Projects -> Streams. Two new streams called EMnifyEventData and EMnifyUsageData should be visible. To inspect recent events, click on one of the EMnify streams which will show recent events and the JSON content delivered:
Before being able to build dashboards, it's necessary to save queries that graphs will use as their data source. It's a good idea to create multiple queries as a first step which can later be graphed in various formats from bar graphs, pie charts, line graphs for time series insights and more. A core set of the most relevant queries for your fleet can then be individually cloned, customised and filtered to produce more focused or specified dashboards.
To create a query, navigate to Explorer and select Query - in our examples, we will be using Explorer V6 which is the latest version of the UI component for building graphing queries. The foundation of each query will be to choose an Event Collection (either EMnifyEventData or EMnifyUsageData) and the Analysis type which in our examples will use basic operations of count, count_unique and sum.
Showing the top devices by data usage is a simple and effective way to identify devices which are using more data than expected. This can be especially helpful for troubleshooting misconfigured devices which may consume a large amount of data. To build this query:
For this query, we will be interested in looking at warning events. This is achieved in Keen.io with the use of the filtering function by the severity of the event which is delivered by the EMnify platform in the
event_severity JSON object.
For this query, we will be interested in looking at usage data with SMS as the traffic type. This is achieved in Keen.io with the use of the filtering function by the traffic_type delivered by the EMnify platform and using traffic type with an ID of 6 for SMS.
To create a chart that graphs PDP context creation and deletion events;
The following graph will allow for a count of unique devices per network over the previous four days. To build this query;
The following pie chart will allow for a count of unique devices per radio access technology over the previous two weeks. In this way we can achieve an overview of which types of radio technologies have been used at least once by any given device. To build this query;
The RAT Type IDs reported are
After at least one query has successfully been saved, it's possible to include it in a dashboard. To create a dashboard, navigate to Dashboards and give it the name Emnify Dashboard
When each query has an associated chart, click the eye icon to preview the dashboard. When the preview is active, the charts can be interacted with on mouse hover and the associated endpoint IDs are visible for inspecting peaks or time periods. A tooltip displays a breakdown of represented values for the chart with the endpoint IDs displayed:
In this guide, we have learned how to create simple dashboards which provide actionable insights into the data consumption, SMS and network activity of your devices. With each dashboard that is created, the dashboard or individual charts can be embedded into separate web pages. This is relevant for inclusion in existing operational dashboards for cross-referencing application troubleshooting with device network information. More details on creating detailed queries for embedded dashboards can be found on the Keen.io documentation for Embedded Analytics.