Adding MQTT Parameters¶
An MQTT parameter maps a single field within the incoming message payload to a trackable data point in Enture. Once added, the platform extracts that field from every matching message and makes the value available for dashboards, reports, alerts, and real-time views.
Before you begin¶
- The MQTT Device must already exist.
- You need the exact field name (identifier) of the value within the message payload, as published by the device.
Steps¶
1. Open the MQTT Device¶
In the left sidebar, go to Digital Twin → Devices and open the device you want to add a parameter to.
2. Add a parameter¶
Click Add Parameter.
3. Fill in the parameter details¶
| Field | Description |
|---|---|
| Name | A descriptive name for this data point (e.g. Temperature, Humidity) |
| Identifier | The field name/path in the message payload that holds this value |
| Data Type | The data type of the value |
| Unit | The engineering unit (e.g. °C, %RH). Optional. |
| Data Processing | Average (mean of samples over the period) or Difference (change over the period, useful for counters) |
4. Common settings¶
Correction Factor, Addition Constant, Idle Latency, Entropy, Restrict User Access, Aliasing, and Calculate Consumption work the same way as on every other protocol — see Common Parameter Settings for details.
5. Save¶
Click Create. The parameter is added to the device.
What happens next¶
The edge device receives the updated parameter list within approximately 30 seconds and begins extracting this field from incoming messages.
Viewing live data¶
- Navigate to Digital Twin → Devices → open the device.
- Click on the parameter name.
- The parameter detail page shows the current value and a real-time chart.
Tip
If you do not see data arriving after a few minutes, verify that:
- The device is actually publishing to the configured topic (check with an MQTT client such as MQTT Explorer or
mosquitto_sub). - The parameter's identifier matches the exact field name in the published payload.
- The device's identifier/identifier value correctly matches this device's messages, if the topic is shared with other devices.