Azure Event Hubs Setup Guide

Prerequisites

Before starting, make sure you have the following:

• An Azure account with an Event Hubs namespace and at least one Event Hub
• Access to the Azure Portal with permissions to manage Shared Access Policies

Setup Guide

Step 1: Get the Connection String from Azure

1. Open the Azure Portal and navigate to your Event Hubs namespace.
2. In the left navigation pane, under Settings, click Shared Access Policies.
3. Select a policy with Manage scope (required to discover all Event Hubs in the namespace), or click + Add to create one.
4. Copy the generated Connection string–primary key — you will need it to configure your connection.

Step 2: Create a Consumer Group in Azure

1. Go to the specific Event Hub instance you want to sync.

2. Navigate to Entities → Consumer Groups.

3. Click + Consumer Group, enter a name unique to this integration, and save it.

   Note: Reusing a consumer group across multiple consuming applications can cause read conflicts. Create a dedicated consumer group for Matia.

Step 3: Complete Asset Configuration in Matia

1. Enter your Connection String copied from Azure.
2. Enter your Consumer Group name created in Azure.
3. Select your message type: JSON or Text.
   • If you choose JSON, select a sync type: Packed or Unpacked.
   • If you choose Text, messages are synced as-is into a single raw value column.
4. Enter an Asset Name.
5. (Optional) Enter a Description.
6. (Optional) Assign Tags.
7. Select an Owner.
8. Verify that your Event Hubs connection is successful by clicking Test Connection.
9. Click Connect.