Pushing Data to Azure Time Series Insights

IMPORTANT NOTE

This is only supported in the current NIGHTLY version of Azure Injector (as of Mar 3, 2021). This will be made standard in the 4.0.7 release of Azure Injector.

Prerequisites

Complete the Getting Started: Azure Injector Quick Start
Complete the Using IoT Hub Message Based Routing tutorial

Summary

This tutorial will provide step-by-step instructions for the following:

Setting up an Azure Time Series Insights environment
Publishing live tag data and events to Time Series Insights via Azure IoT Hub
Viewing the data that has been pushed to Time Series Insights

Upon completion of this tutorial you will have an Ignition Gateway with the Azure Injector module connected and publishing live tag data to an Azure IoT Hub which will be configured as a data source for Time Series Insights. Those messages will then be automatically stored in Time Series Insights.

Tutorial

Step 1: Make sure you have completed the Getting Started: Azure Injector Quick Start and Using IoT Hub Message Based Routing

Parts of the environment created and configured in the Quick Start and Message Based Routing tutorial are used in this guide. So, make sure you have completed this before proceeding.

Step 2: Setting up the Time Series Insights environment

Log into to https://portal.azure.com and type 'Time Series Insights Environments' into the search bar at the top as shown below and select 'Time Series Insights Environments'.

After doing so, you should see the following. Click the '+ Add' Button near the top left corner to create a new Time Series Insights Environment.

After clicking the 'Add' button, you will see the following.

Set the Subscription, Resource Group, and environment name, and Location as shown above. Then scroll down. After doing so, you will see the following.

Set three property names as shown above. Set them to:

topic.edgeNodeDescriptor
topic.deviceId
payload.metrics.name

These property names line up with JSON Object members that are pushed to IoT Hub by the Azure Injector module in Ignition.

In addition, set a 'Storage acocunt name' as shown above and leave the other fields default. Now click 'Next: Event Source'. After doing so, you should see the following.

As shown above, set the Name, Subscription, IoT Hub name, IoT Hub access policy name, IoT Hub consumer group, and set the timestamp property name to 'payload.metrics.timestamp'. This will tell Time Series Insights to use the incoming timestamp for the tag value to be used as the timestamp to store in the time series database. Finally, click 'Review + Create'. This will show something similar to the following.

Finally click 'Review + Create' to create the new Time Series Environment. This will take a few minutes to complete. When creation is complete, you should see the following.

Click 'Go to resource' to see the new Time Series Insights Environment.

Contents

Cirrus Link Resources

Inductive Resources