You are viewing documentation for an older version of Confluent Platform. For the latest, click here.

MQTT Source Connector

This connector connects to a MQTT broker and subscribes to the specified topics. SSL is supported. For information on how to create SSL keys and certificates see Security Tutorial. For the relevant configuration properties, see the MQTT source sonnector configuration reference.


If you need to change the topic take a look at the RegexRouter transformation which can be used to change the topic name before it is written to Kafka.


The output of this connector is an envelope with all of the properties of the incoming message. The body of the message is written to the value as bytes. The key is the topic the message was written to.


Property based example

This configuration is used typically along with standalone workers.

mqtt.server.uri=< Required Configuration >
mqtt.topics=< Required Configuration >

Rest based example

This configuration is used typically along with distributed workers. Write the following json to connector.json, configure all of the required values, and use the command below to post the configuration to one the distributed connect worker(s). Check here for more information about the Kafka Connect Rest API

Connect Distributed REST example
  "config" : {
    "name" : "MqttSourceConnector1",
    "connector.class" : "io.confluent.connect.mqtt.MqttSourceConnector",
    "tasks.max" : "1",
    "mqtt.server.uri" : "< Required Configuration >",
    "mqtt.topics" : "< Required Configuration >"

Use curl to post the configuration to one of the Kafka Connect Workers. Change http://localhost:8083/ the the endpoint of one of your Kafka Connect worker(s).

Create a new connector
curl -s -X POST -H 'Content-Type: application/json' --data @connector.json http://localhost:8083/connectors
Update an existing connector
curl -s -X PUT -H 'Content-Type: application/json' --data @connector.json http://localhost:8083/connectors/MqttSourceConnector1/config