How-To Guides
Integration Guides

Azure Event Hub Integration Guide

7min

Review the following guide for setting up an integration between Litmus Edge and Azure Event Hub.

The Azure Even Hub connector is based on the Azure official SDK.

Before You Begin

You must have an Azure account.

Step 1: Add a Device



Step 2: Add Tags



Step 3: Add the Azure Event Hubs Connector

Follow the steps to Add a Connector 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.

Document image


If you see a Failed status, you can review the Connector Logs 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.



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.

    Azure Event Hub
    Azure Event Hub
    
  3. Navigate to Process Data > Explore to see the messages in a tabular form.

    Explorer view in Azure
    Explorer view in Azure