Pushing data to Azure Event Hubs

Consibio Cloud can push your project’s data to an Azure Event Hub instance as it arrives. Every time new values are logged in the project — from devices, integrations or virtual sensors — Consibio Cloud sends a message to your Event Hub, so you can process the data in your own systems in near real-time.

What you need

• A project in Consibio Cloud where you have the admin or owner role.
• An Event Hub instance in your Azure subscription.
• The connection string for the Event Hub. Follow Microsoft’s guide Get an Event Hubs connection string to obtain it.

Setting up the integration

1. Open your project in Consibio Cloud.
2. In the left menu, select More, open the Settings section and select Integrations.
3. Select Add new integration. A panel opens with the new integration.
4. Give the integration a name, and make sure Integration type is set to Azure Event Hub.
5. Save your changes.

Saving the connection string

The connection string is stored as a secret: the dashboard only lets you update it — it is not displayed again after saving. Only project admins and owners can edit it.

1. Open the integration from the Integrations view.
2. Under Connection string, select Edit secret.
3. Paste the connection string from Azure and save.

Consibio Cloud starts pushing new values to your Event Hub right away. Note that only values logged after the integration is set up are pushed — historical data is not sent. To pull historical data, use the REST API instead.

The standard payload

Each message sent to your Event Hub is a JSON document with all the numeric values from one value event:

{
  "time": 1756106468,
  "datetime": "2025-08-25T07:21:08Z",
  "project_id": "your_project_id",
  "values": {
    "element_id_1": 21.5,
    "element_id_2": 7.2
  }
}

• time — when the values were measured, as a Unix timestamp in seconds.
• datetime — the same time as an ISO 8601 string in UTC.
• project_id — the ID of your Consibio Cloud project.
• values — the measured values, keyed by element ID. Only numeric values are forwarded; text values are left out.

To map element IDs to your elements, open the Elements view under Settings, or list the project’s elements with the REST API.

Custom payloads

If you need messages in a different format — for example to match an existing ingestion pipeline — Consibio Cloud also supports custom payload templates, where you control the exact structure of each message. Reach out to support@consibio.com to have custom payloads set up for your project.

Troubleshooting

• No messages arrive in the Event Hub: check that the connection string is correct and includes the EntityPath of your Event Hub, and that new values are actually being logged in the project.
• Some values are missing: only numeric values are pushed — text values are not included in the standard payload.

If you are stuck, contact support@consibio.com.