---
title: Azure Event Hub Integration Guide
slug: bhdo-v1/azure-event-hub-integration-guide
createdAt: 2022-11-24T18:23:50.000Z
---

Review the following guide for setting up an integration between Belden Horizon Data Operations and [Azure Event Hub](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-about).

The Azure Even Hub connector is based on the [Azure official SDK](https://github.com/Azure/azure-event-hubs-go).

# Before You Begin

Make sure you have an Azure account. 

# Step 1: Add a Device

Follow the steps to [Connect a Device](docId\:T-cWPe0_Jsfw5-aoj8WPP). The device will be used to store tags that will be eventually used to create outbound topics in the connector. Make sure to select the **Enable Data Store** check box. 

# Step 2: Add Tags

After connecting the device in Belden Horizon Data Operations, you can [Add Tags](docId\:Wpe2HMXelARLBnhWbuChY) to the device. Create tags that you want to use to create outbound topics for the connector. 

# Step 3: Add the Azure Event Hubs Connector

Follow the steps to [Add a Connector](docId\:rrskXSXVcBZSd6UWyJ-yv) and select the **Azure Event Hubs** provider. 

Configure the following parameters. 

- **Name**: Enter a name for the connector. 
- **Connection String**: Copy the string from your Azure SAS Policy and paste it here.
- **Maximum Message Size**: The maximum message size in KB. The default value is 256. 
- **Parallel Connections Count**: The maximum number of parallel connections from your edge device to Azure Event Hub. The default value is 50. 
- **Combine Messages**: Select the check box to combine messages (thus reducing the number of parallel connections). 
- **Throttling limit**: The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit. 
- **Persistent storage**: When enabled, this will cause messages to undergo a store-and-forward procedure. Messages will be stored within Belden Horizon Data Operations when cloud providers are online.  

# Step 4: Enable the Connector

After adding the connector, click the toggle in the connector tile to enable it. 

::Image[]{src="https://api.archbee.com/api/optimize/vAqK-046vdh4I0e1y9cfX/Dk0hsHUBterDYoK7IcPPe_azureeventhub.png" size="60" width="370" height="345" position="center" showCaption="false"}

If you see a *Failed *status, review the [Connector Logs](docId\:wciGtqYdwS5P7BnDd7LId) and any relevant error messages. 

# Step 5: Create Outbound Topics for Connector

You will now need to create outbound topics for the connector from the tags created in Step 2.

**To create outbound topics:**

1. Click the connector tile.
   The connector *Dashboard *appears. 
2. Click the **Topics **tab. 
3. Click the **Import from DeviceHub** tags icon. 
   The *DeviceHub Import *dialog box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4fC8yaOKctxiiTvUDGfWu_import-from-devicehub.png" size="80" width="1148" height="570" position="center" showCaption="false"}
4. Select all the tags to import and click **Import**. 

After importing the tag(s), do the following:

- Edit the tag and configure the **Remote Data Topic**. Copy and paste the name of your Azure Event Hub. 
- Click the **Enable **toggle to enable the topic. 
- Make sure the connector has a CONNECTED status. 

# Step 6: Verify Connection in Azure

**To verify the connection in Azure: **

1. Open the Azure portal. 
2. Open the Event Hub you have connected to and see statistics on the messages it receives from the Belden Horizon Data Operations outbound topic. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/PFUAlTjXqElSfTZ8yklmF_azure-event-hub-11000x350.png" size="80" width="1000" height="350" caption="Azure Event Hub" position="center" showCaption="true"}
3. Navigate to **Process Data > Explore** to see the messages in a tabular form. 

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/AKN5ZJuCRyFfeNkiX5xOU_azure-event-hub-21000x379.png" size="80" width="1000" height="379" caption="Explorer view in Azure" position="center" showCaption="true"}