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

You can integrate Belden Horizon Data Operations with [Azure Event Hub](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-about) to support an outbound connection. This enables you to publish data from a topic in your edge device to an Event Hub in the Azure portal.

The 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.&#x20;

# Step 1: Add a Device

Follow the steps to [Connect a Device](https://public-docs.litmus.io/bhdo/connect-a-device). 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.&#x20;

# Step 2: Add Tags

After connecting the device in Belden Horizon Data Operations, you can [Add Tags](https://public-docs.litmus.io/bhdo/add-tags) to the device. Create tags that you want to use to create outbound topics for the connector.&#x20;

# Step 3: Add the Connector

Follow the steps to [Add a Connector](https://public-docs.litmus.io/bhdo/add-a-connector) and select the **Azure Event Hubs** provider.&#x20;

Configure the following parameters.&#x20;

- **Name**: A recognizable name to identify the connector.&#x20;
- **Connection String**: Copy the string from your Azure SAS Policy and paste it here.
- **Entry Name**: Copy the name of your Azure Event Hub and paste it here.
- **Maximum Message Size**: The maximum message size in KB. The default value is 256.&#x20;
- **Parallel Connections Count**: The maximum number of parallel connections from your edge device to Azure Event Hub. The default value is 50.&#x20;
- **Combine Messages**: Select the check box to combine messages (thus reducing the number of parallel connections).&#x20;
- **Throttling limit**: The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit.&#x20;
- **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. &#x20;

# Step 4: Enable the Azure Event Hubs Connector

**To enable the connector:&#x20;**

1. Return to the *Belden Horizon Data Operations Integration* browser tab.
2. Click the connection toggle on the connector tile.&#x20;
   The connector shows connected after verifying the connection.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Q_kY75Flp1wzta2C9iivN_azureevent.png" size="60" width="353" height="262" caption="Toggle to enable connector" position="center" showCaption="true"}

# Step 5: Add Outbound Topics to Azure Event Hubs 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&#x20;*&#x61;ppears.&#x20;
2. Click the **Topics&#x20;**&#x74;ab.&#x20;
3. Click the **Import from DeviceHub** tags icon.&#x20;
   The *DeviceHub Import&#x20;*&#x64;ialog 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**.&#x20;

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.&#x20;
- Click the **Enable&#x20;**&#x74;oggle to enable the topic.&#x20;
- Make sure the connector has a CONNECTED status.&#x20;

# Step 6: Verify Connection in Azure

**To verify the connection in Azure:&#x20;**

1. Open the Azure portal.&#x20;
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.&#x20;

   ::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.&#x20;

   ::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"}

