---
title: Azure Event Hub Integration Guide
slug: litmusedge-v1/how-to-guides/integration-guides/azure-event-hub
description: Learn how to set up the Azure Event Hub connector. 
docTags: 
createdAt: 2022-11-24T18:23:50.000Z
---

Review the following guide for setting up an integration between Litmus Edge 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

You must have an Azure account. 

# Step 1: Add a Device

Follow the steps to [Connect a Device](docId:3eyAfPpweuVmBLCEy17sq). 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** checkbox. 

# Step 2: Add Tags

After connecting the device in Litmus Edge, you can [Add Tags](docId:8sE7z3PmRfwL1nmzcwaLX) 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\:b7eMDh8AO2-NOqDHwPD7Y) and select the **Azure Event Hubs** provider. 

Configure the following parameters. 

- **Name**: A recognizable name to identify 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 checkbox 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 Litmus Edge when cloud providers are online.  
- **Queue Mode**: Select the queue mode as **lifo **(last in first out) or **fifo **(first in first out). Selecting **lifo **means that the last data entry is processed first, and selecting **fifo **means the first data entry is processed first. 

# 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/SSUUxKZUk9bFTEPNn_6Zo/RfS2qA0T3Wa13MG-ghHFF_azureeventhubs.png" size="60" width="388" height="358" position="center" showCaption="false"}

If you see a *Failed *status, you can review the [Connector Logs](docId:5hctoRLhgaX3Ikh_lvi0A) and relevant error messages. 

# Step 5: Add 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.

![](https://api.archbee.com/api/optimize/xSuIWwMa6RnsbeD5Kdqd7-zaOGMDYbPZWYALvLBgotp-20250606-203859.png)

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

1. Edit the tag and configure the **Remote Data Topic**. Copy and paste the name of your Azure Event Hub. 
2. Click the **Enable **toggle to enable the topic. 
3. 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 Litmus Edge 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"}