====MQTT Per-Asset Topics====

This type of [[start|distribution]] sends incoming data to your MQTT server, with one topic per ARDI asset that has live data.

This will consolidate all updates about an asset into a single message, reducing the total size of the MQTT namespace and reducing the number of total messages sent.

As an alternative that has one MQTT message per //point of data//, see [[mqtt|mqtt]].

===Type Name===

The type name to use in your configuration is **mqttob** (MQTT OBject based).

===Configuration===

The following configuration options are accepted...

^Name^Notes^Purpose^
|hostname|Required|The DNS name or IP of your MQTT server|
|port|Default 1883|The port number used to communicate to the MQTT server|
|topic|Required|The base topic to publish to|
|username||The username to connect to the MQTT server|
|password||The password to connect to the MQTT server|

===Suggestions===

We usually suggest using the **fullpath** option in your [[configuring_live_data_distribution|configuration]] to replicate your ARDI asset hierarchy in your MQTT system. But this is not a requirement.

===Example Payload===

<code javascript>
{
   "Temperature - Actual" : 92.5,
   "Temperature - Target": 92,
   "Status": 1
</code>