Measurement readings can be acquired through MQTT using JSON.


Please have a look at MQTTKit application about how to configure a MQTT application.

Basic examples#

Setup “mosquitto_pub”:

aptitude install mosquitto-clients

Define where to send data to:

export MQTT_BROKER=localhost
export MQTT_TOPIC=mqttkit-1/testdrive/area-42/node-1

Single readings#

Publish single sensor readings:

mosquitto_pub -h $MQTT_BROKER -t $MQTT_TOPIC/data/temperature -m '42.84'

Multiple readings#

Publish multiple sensor readings using JSON:

mosquitto_pub -h $MQTT_BROKER -t $MQTT_TOPIC/data.json -m '{"temperature": 42.84, "humidity": 83}'

Readings with timestamp#

Publish sensor reading with timestamp in ISO 8601 format:

mosquitto_pub -h $MQTT_BROKER -t $MQTT_TOPIC/data.json -m '{"time": "2016-12-07T17:30:15Z", "temperature": 42.84, "humidity": 83}'

See also the whole list of Timestamp formats.


Events can be published to the MQTT topic suffix /event.json. Grafana Annotations will be created automatically. Read more about it at MQTT events.

CSV format#


Not implemented yet.

Periodic acquisition example#


The characteristics of sawtooth signals (dynamic, slowly oscillating) are convenient to generate measurement sensor readings and publish telemetry data without having any hardware in place.

For getting started, please read about how to generate a dynamic, slowly oscillating sawtooth signal and publish it to MQTT.

Language bindings#

See MQTT libraries.


See also

Please read about general MQTT error signalling and Troubleshooting.