kafka-connect-mqtt

This repo contains a MQTT Source and Sink Connector for Apache Kafka. It is tested with Kafka 2+.

Using the Source connector you can subscribe to a MQTT topic and write these messages to a Kafka topic.

The Sink connector works the other way around.

Note:

• SSL connections are not supported at the moment
• The connector works only with a single task. Settings maxTasks > 1 has no effect.

Building the connector

To build the connector, you must have the following installed:

• Java 8 or later
• Maven
• GIT

Clone the repository with the following command:

git clone https://github.com/johanvandevenne/kafka-connect-mqtt.git

Change directory into the kafka-connect-mqtt directory

cd kafka-connect-mqtt

Build the connector using Maven

mvn clean install

Installing the connector

Prerequisites

You must have Kafka 2+ installed

Installing

• Copy the folder /target/kafka-connect-mqtt-1.0-0-package/share/kafka-connect-mqtt to your Kafka Connect plugin path
• Restart Kafka Connect
• Check if the connector has been loaded succesfully

http://<kafkaconnect>:8083/connector-plugins

If you see these entries, the connector has been installed succesfully

{
    "class": "MQTTSinkConnector",
    "type": "sink",
    "version": "1.0.0"
},
{
    "class": "MQTTSourceConnector",
    "type": "source",
    "version": "1.0.0"
},

Configuring the Source connector

The MQTT Source connector subscribes to a Topic on a MQTT Broker and sends the messages to a Kafka topic.

Here is a basic configuration example:

curl -X POST \
  http://<kafkaconnect>:8083/connectors \
  -H 'Content-Type: application/json' \
  -d '{ "name": "mqtt-source-connector",
    "config":
    {
      "connector.class":"be.jovacon.kafka.connect.MQTTSourceConnector",
      "mqtt.topic":"my_mqtt_topic",
      "kafka.topic":"my_kafka_topic",
      "mqtt.clientID":"my_client_id",
      "mqtt.broker":"tcp://127.0.0.1:1883",
      "key.converter":"org.apache.kafka.connect.storage.StringConverter",
      "key.converter.schemas.enable":false,
      "value.converter":"org.apache.kafka.connect.storage.StringConverter",
      "value.converter.schemas.enable":false
    }
}'

Optional Configuration options

• mqtt.qos (optional): 0 – At most Once, 1 – At Least Once, 2 – Exactly Once
• mqtt.automaticReconnect (optional)(default: true): Should the client automatically reconnect in case of connection failures
• mqtt.keepAliveInterval (optional)(default: 60 seconds)
• mqtt.cleanSession (optional)(default: true): Controls the state after disconnecting the client from the broker.
• mqtt.connectionTimeout (optional)(default: 30 seconds)
• mqtt.username (optional): Username to connect to MQTT broker
• mqtt.password (optional): Password to connect to MQTT broker

Configuring the Sink connector

The MQTT Sink Connector reads messages from a Kafka topic and publishes them to a MQTT topic.

Here is a basic configuration example:

curl -X POST \
  http://<kafkaconnect>>:8083/connectors \
  -H 'Content-Type: application/json' \
  -d '{ "name": "mqtt-sink-connector",
    "config":
    {
      "connector.class":"be.jovacon.kafka.connect.MQTTSinkConnector",
      "mqtt.topic":"my_mqtt_topic",
      "topics":"my_kafka_topic",
      "mqtt.clientID":"my_client_id",
      "mqtt.broker":"tcp://127.0.0.1:1883",
      "key.converter":"org.apache.kafka.connect.storage.StringConverter",
      "key.converter.schemas.enable":false,
      "value.converter":"org.apache.kafka.connect.storage.StringConverter",
      "value.converter.schemas.enable":false
    }
}'

Optional Configuration options

• mqtt.qos (optional): 0 – At most Once, 1 – At Least Once, 2 – Exactly Once
• mqtt.automaticReconnect (optional)(default: true): Should the client automatically reconnect in case of connection failures
• mqtt.keepAliveInterval (optional)(default: 60 seconds)
• mqtt.cleanSession (optional)(default: true): Controls the state after disconnecting the client from the broker.
• mqtt.connectionTimeout (optional)(default: 30 seconds)
• mqtt.username (optional): Username to connect to MQTT broker
• mqtt.password (optional): Password to connect to MQTT broker

Authors

• Johan Vandevenne - Initial work