How To Guide: Keen IO Connector Plugin

 

July 05, 2016  |  By Dale Rankine

Keen IO is a set of powerful APIs that allow you to collect, analyze, and visualize events from anything connected to the internet.

 
The Keen IO Connector Plugin, which is developed by Reekoh, enables you to send and synchronize device data to the Keen IO platform for analytics and data visualization. We’ll show you how to use the plugin through the guide below.
 
To start off, login to your Reekoh account and then navigate to Devices > Register New Device. Complete the form that comes next. You can also use any existing registered device in your instance, if you have one.
 
N1
 
After registering your device, install the plugins you will be using: Keen IO Connector and MQTT Gateway (this will enable you to ingest device data via MQTT protocol). Locate these plugins in the Plugin Store, and then install them to your instance.
 
N1
 
Next is to create your topology by navigating to Topologies > Build New Topology. Complete the form that comes next.
 
N1
 
Once your topology is set, configure your installed plugins by locating their respective categories in your topology. For example, the Keen IO plugin should be configured under the Connector category. Click Configure New, and then complete the form that comes next.
 
N1
 
N1
 
Upon reaching the Configure Plugin page, you will be required to provide the Project ID and Write Key of your Keen IO project. To get these details, log in to your Keen IO account and then select your Project from the list.
 
N1
 
Once you’re in your selected project’s page, you’ll be able to see the Project ID and API Keys. Click Show API Keys to get the Write Key.
 
N1
 
N1
 
Go back to the Configure Plugin page to continue with completing the form. Paste the details in their respective fields, and then provide a value for Collection.
 
N1
 
After you’ve configured both plugins, you should be able to see them in your topology.
 
N1
 
Next, download or install any MQTT simulator from the Chrome Web Store to be able to send device data to the Keen IO platform. We’ll be using MQTTLens for this example. Open the application, and then create a connection for your device by completing the form that comes next.
 
N1
 
N1
 
Once connection has been established, enter or paste your JSON data in the Message field; then supply any Topic for your data. Click Publish to send it to the Keen IO platform.
 
N1
 
To check if your data has been received, go back to your Keen IO account. Navigate to the project you selected earlier, and then select Explorer on the upper right corner of the page. Create a new query by filling out the form that comes next (For this example, refer to the highlighted fields in the image below). Click Run Query.
 
N1
 
You should be able to see the data in the generated chart. You may select from the drop-down menu on the upper right corner on how you want to view your data chart.
 
N1
 
N1
 
You can check out our Basic Starter guide in the Reekoh Help Center for more info.