MQTT Source
Provided by: "Apache Software Foundation"
Support Level for this Kamelet is: "Stable"
Receives each message published to a topic on an MQTT broker, such as Eclipse Mosquitto or HiveMQ, with MQTT 3.1.1.
Use it to collect readings and events from IoT devices and other MQTT clients. A topic with wildcards, such as sensors/#, receives from many topics at once. For a broker or clients that use MQTT 5, use mqtt5-source.
Output: the body is the payload, as bytes. The CamelMqttTopic header is the topic the message was published to, and CamelMqttQoS its quality of service.
Good to know: it receives only the messages published while it is connected, plus, when it subscribes, the last retained message of each matching topic. It subscribes with quality of service 2 (exactly once) unless qos is set. Each running copy needs its own clientId: two clients with the same ID keep pushing each other off the broker and lose messages. When it is not set, a unique one is generated. It connects with no TLS unless brokerUrl starts with ssl://. With TLS it checks the certificate and the host name of the broker, and trusts the certificate authorities that Java trusts by default, or instead the ones in sslTruststoreLocation. The integration fails to start when the broker cannot be reached or fails these checks.
Configuration Options
The following table summarizes the configuration options available for the mqtt-source Kamelet:
| Property | Name | Description | Type | Default | Example |
|---|---|---|---|---|---|
Broker URL | Required The address of the MQTT broker, as | string | tcp://mosquitto:1883 | ||
Topic | Required The topic to subscribe to. | string | sensors/# | ||
Client ID | The client ID that names this connection to the broker. It must be unique on the broker: a second client with the same ID pushes the first one off. When it is not set, a unique ID is generated. | string | sensor-reader-1 | ||
Password | The password to log in to the broker with, for the user | string | |||
Quality of Service | The highest quality of service to receive messages with: 0 (at most once, with no confirmation), 1 (at least once, a message can arrive twice) or 2 (exactly once). The broker sends each message with the lower of this and the quality of service it was published with, which the Enum values: * 0 * 1 * 2 | integer | 1 | ||
SSL Truststore Location | The path of a trust store file, in JKS or PKCS12 format, with the certificate of the authority that signed the certificate of the broker. Needed only with an | string | /etc/mqtt/truststore.jks | ||
SSL Truststore Password | The password of the trust store file in | string | |||
Username | The user name to log in to the broker with. Leave it empty for a broker that accepts clients without a login. | string |
Dependencies
At runtime, the mqtt-source Kamelet relies upon the presence of the following dependencies:
-
camel:paho
-
camel:kamelet
Camel JBang usage
Prerequisites
-
You’ve installed JBang.
-
You have executed the following command:
jbang app install camel@apache/camel Supposing you have a file named route.yaml with this content:
- route:
from:
uri: "kamelet:mqtt-source"
parameters:
.
.
.
steps:
- to:
uri: "kamelet:log-sink" You can now run it directly through the following command
camel run route.yaml MQTT Source Kamelet Description
Authentication
This Kamelet supports MQTT authentication using username and password credentials. It can also connect to MQTT brokers without authentication if not required.
Configuration
The MQTT Source Kamelet supports the following configurations:
-
Topic: MQTT topic to subscribe to, with the
+and#wildcards (required) -
Broker URL: MQTT broker URL (required, e.g., tcp://broker.example.com:1883, or ssl://broker.example.com:8883 for TLS)
-
Username: Username for MQTT authentication (optional)
-
Password: Password for MQTT authentication (optional)
-
Client ID: MQTT client identifier; a unique one is generated when it is not set. Two clients with the same ID push each other off the broker.
-
Quality of Service (
qos): the highest QoS to receive messages with, 0, 1 or 2; 2 when it is not set -
SSL Truststore Location and SSL Truststore Password: a trust store file (JKS or PKCS12) with the certificate authority of the broker, for an
ssl://broker with a certificate from a private or self-signed authority
The Kamelet subscribes with a clean session, so it receives only the messages published while it is connected, plus, when it subscribes, the last retained message of each matching topic. It has no option to change the session.
Output Format
The Kamelet outputs the MQTT message payload as bytes, with the CamelMqttTopic and CamelMqttQoS headers.
Usage Example
- route:
from:
uri: "kamelet:mqtt-source"
parameters:
topic: "sensors/temperature"
brokerUrl: "tcp://mqtt.example.com:1883"
username: "mqttuser"
password: "mqttpass"
steps:
- to:
uri: "kamelet:log-sink" Example with a Wildcard and a Client ID
- route:
from:
uri: "kamelet:mqtt-source"
parameters:
topic: "critical/#"
brokerUrl: "tcp://mqtt.example.com:1883"
username: "mqttuser"
password: "mqttpass"
clientId: "camel-consumer-1"
steps:
- to:
uri: "kamelet:log-sink" Example with SSL/TLS
With an ssl:// address the Kamelet connects with TLS, checks the certificate and the host name of the broker, and trusts the certificate authorities that Java trusts by default. When the broker has a certificate from a private or self-signed authority, put the certificate of that authority in a trust store file and set sslTruststoreLocation and sslTruststorePassword; the Kamelet then trusts the authorities in that file instead.
keytool -importcert -alias mqtt-ca -file ca.crt -keystore truststore.jks -storepass changeit - route:
from:
uri: "kamelet:mqtt-source"
parameters:
topic: "secure/data"
brokerUrl: "ssl://mqtt.example.com:8883"
username: "mqttuser"
password: "mqttpass"
sslTruststoreLocation: "/etc/mqtt/truststore.jks"
sslTruststorePassword: "changeit"
steps:
- to:
uri: "kamelet:log-sink" Quality of Service Levels
-
QoS 0: At most once delivery (fire and forget)
-
QoS 1: At least once delivery (acknowledged delivery)
-
QoS 2: Exactly once delivery (assured delivery)
The Kamelet subscribes with the QoS in qos, or 2 when it is not set; a message is received with the lower of that and the QoS it was published with. The CamelMqttQoS header tells which.
- route:
from:
uri: "kamelet:mqtt-source"
parameters:
topic: "sensors/#"
brokerUrl: "tcp://mqtt.example.com:1883"
qos: 1
steps:
- to:
uri: "kamelet:log-sink"