Configure the product to receive Azure IoT Hub messages

To configure Insight to receive messages from an IoT Hub, you must get information about your IoT Hub from Azure, then use that information to set up the IoT Hub data source in Insight.

To retrieve Azure IoT Hub information

1. In your Azure portal, select the Event Hub you set up for Insight.

2. Select Built-in endpoints.

3. Note the following IoT Hub information:

   • Event Hub-Compatible Name

   • Consumer Group

   • Event Hub-compatible endpoint

     Note: Before you note the Event-Hub compatible endpoint, select a shared access policy other than iothubowner to ensure that a connection with minimum required privileges is used.

After you have noted the IoT Hub information, you can define an Azure IoT Hub as an Insight data source.

To define an Azure IoT Hub data source

4. Select Administration from the navigation rail.

5. Select Data Sources.

   

6. Select and then select Azure IoT/Event Hub.

   The Add Azure IoT/Event Hub Data Source dialog displays.

7. Type a name for the data source you are creating in Insight in the Name field.

8. Type the name of the Iot Hub you created in your Azure portal for use with Insight in the Azure IoT/Event Hub Name field.

   This is the Event Hub-Compatible Name you defined in Azure.

9. Specify the Connection String.

   This is the Event Hub-compatible endpoint you generated in Azure. See Get connection string and consumer group information from Azure.

10. Type the Consumer group.

    This is the consumer group in Azure that you are using with Insight. See Get connection string and consumer group information from Azure.

    

11. Under Options, you can toggle the Events checkbox to configure the data source for events support. See Processing Event data from an Event Hub/IoT Hub data source for more information. Note that Process Data is enabled by default and cannot be unchecked.

12. Optionally, do one of the following to specify the location for all unassigned tags in this data source:

    • Choose a location from the drop-down list.

    • Type a new location.

13. Below Geolocation Coordinates, specify the following to be applied to all unassigned tags in this data source:

    • Latitude in decimal degrees with plus/minus format (where "+" is optional).

    • Longitude in decimal degrees with plus/minus format (where "+" is optional).

    • Elevation (optional) noted in meters above sea level, specified to the first decimal place (for example:10.0 or 1322.5).

    Note: For latitude and longitude, do not use degree, minute, second (DMS) or decimal degrees with N/E/S/W. Geolocation values may include decimal separators, consistent with English culture.

14. Select Test Connection.

    If the connection is not successful, you receive an error message informing you what the issue is. Some issues you may encounter are:

    • incorrect connector settings

    • connection string is not using a listen claim

    • another component is already connected to the same Azure IoT/Event Hub

    You can correct the issue, then select Test Connection again.

    If there are no issues, you receive a message that the connection was successful, and the OK button displays.

15. Select OK to continue.

    The Upload dialog displays.

    This dialog is not required when setting up an IoT Hub data source.

16. Select Close.