Azure Event Hub

Connect an Azure Event Hub

The following parameters are available to connect an Azure Event Hub

Parameter	Description	Example value
name *	The name of the destination	My Event Hub
description *	Description of the destination
url *	URL of your Event Hubs Namespace	https://myhubs. servicebus.windows.net
eventSpaceName *	The name of your Event Hubs Instance	myeventhub
nameSpaceName *	The name of your Event Hubs Namespace	myhubs
sasKeyName *	SAS Policy name for key with claim "Manage"	myeventhubKey
sasKey *†	Primary key for used SAS Policy	d2llZGl0bGpc2dlaw==

*) required value †) secret value, write only, not returned by our systems

What does the connection do?

All IoT Data from devices linked to the destination is forwarded to the Event Hub in SenML JSON format. Since the Azure Event Hub in itself does not allow you to look into the data coming from KPN Things, we give two easy examples of how to debug IoT data landing in your Event Hub

Example for data debugging #1: Capture

Using the Capture feature of your Event Hub, you can store incoming data in an Azure Storage Container. In the screenshot below it is shown how raw LoRa payload can be found in the avro files generated by the capture feature.

Example for data debugging #2: Process data explorer (Query)

You can use SQL-like queries to explore your Event Hub data in the Process data feature. In the screenshot below it is shown how raw LoRa payload can be found in the data exporer.

Where to find the required configuration values in the Azure Portal?

URL and Namespace name

Open the Overview page of your Event Hubs Namespace in your Azure Portal. You will find the host name of your namespace (#1 in the screenshot) and the name of your namespace (#2 in the screenshot) as highlighted in the screenshot below:

Now, use this value to make the following input values for the Azure Event Hub destination configuration:

• URL: should be of the form https://X.servicebus.windows.net, so put https:// before your host name and you're done.

• Namespace name: should be the name of your namespace.

Event space name

Continue by opening the Overview page of your Event Hubs Instance. Here you will find the name of your Event space, also known as Event Hubs Instance, as highlighted in the screenshot below:

SAS key name and SAS key

Open the Shared access policies page for your Event Hubs Instance. Here you can view and add the access policies of your Event Hub. Open the policy you want KPN Things to use to access your Event Hub. This will give you a view like in the screenshot below:

• SAS key name: #1 in the screenshot above highlights the SAS key name of a selected Policy.

• SAS key: #2 in the screenshot above highlights the SAS key of a selected Policy.

How to create an Azure Event Hub

Don't have an Azure Event Hub yet? Head on over to the Microsoft documentation on how to learn to create an Azure Event Hub:

Azure Quickstart - Create an event hub using the Azure portal - Azure Event Hubsdocsmsft