Dissecting MQTT Using Wireshark

we discussed the mqtt protocol, how it works, and its growing role in the digital landscape in a previous blog post . to better understand the content in this article, read up on the basics of machine to machine (m2m) in the previous post. we will be using the catchpoint mqtt monitor to subscribe and publish to a topic from an mqtt broker. the image below illustrates the test set up using catchpoint.

the metrics from catchpoint’s mqtt monitor includes publish time, publish size, subscribe time, subscribe size, dns, and connect time.

to interpret the data collected using the mqtt monitor, you need to see what happens under the hood and this can be done using wireshark. sniffing tools such as wireshark allow us to dissect each step in the process and examine the data packets. in this analysis, we will use the catchpoint mqtt monitor to set up a sample test and see what is involved in the process.

wireshark analysis

mqtt protocol is based on top of tcp/ip and both the client and broker need to have a tcp/ip stack.

below is the snapshot of a subscribe followed by a publish to the same mqtt broker using the wireshark tool from the catchpoint mqtt monitor. we will be considering a message with the delivery level of qos t0 here. let’s dive into a packet-by-packet analysis of the protocol.

note: in the image above, the ip 192.168.0.11 is the ip of the mqtt broker and the client is 192.168.0.12 that is acting as both the publishing client and the subscribing client.

1. connect message

mqtt connection is between a client and a broker and never directly with another client. the initiation of this connection is using a connect command sent from the client to the broker. the connection, once established, is kept open until the time it does not receive a disconnect command from the client.

the destination port is 1883, which is the default port for mqtt over tcp.

port 8883 is for mqtt over tls.

diving into the connect command details:

• header flags: holds information on the mqtt control packet type.
• connect flags: the connect flag bytes contain parameters specifying the behavior of the mqtt connection. it denotes the presence or absence of fields in the payload.
• clean session: bit 1 of the connection flags. this flag indicates the broker whether the client wants to establish a persistent connection or not. the flag, when set to 'true,' results in a clean session where the subscriptions are removed on disconnection and when set to 'false,' a durable connection can be achieved where subscriptions remain and messages with high qos are delivered on reconnection.
• will flag: bit 2 of the connect flags. part of the last will and testament (lwt) feature of mqtt. this flag, when set, means that, if the connect request is accepted, a will message must be stored on the server. a will message is an mqtt message with a will topic and a will message. this is used while notifying other clients on disconnection. when the client disconnects, the broker sends this message on behalf of it. when the will flag is set to 1, the will qos and will retain fields in the connect flags are used by the server.
• will qos: bit 4 and 3 of the connect flags. denote the qos level to be used while publishing the will message.
• will retain: bit 5 of the connect flags. if will retain is set to 0, the server must publish the will message as a non-retained message and when it is set to 1, the will message is published as a retained message.
• user name and password: bit 7 and 6 of the connect flags respectively. when these fields are set, the credentials are expected in the payload. mqtt allows sending username and password for authenticating a client and for authorization. the password is sent in plaintext if it is not encrypted underneath.
• keep alive: keep alive timer is used to know if an mqtt client is on the network where the client sends regular ping request messages to the broker. broker responds with a ping response.
• client id: is an identifier for each mqtt client connecting to an mqtt broker. it needs to be unique per broker.
• payload: the payload contains client id, will topic, will message, user name, and password fields whose presence is determined by the flags.

2. connect acknowledgment message

on receiving a connect message, the broker responds with a connack message.

• header flags: holds information on the mqtt control packet type.
• session present: bit 0 of the connection ack byte is the session present flag. this flag indicates if the broker has an existing persistent session of the client from previous interactions.
• return code: return code values and responses are shown in the table below

3. subscribe message

a client sends a subscribe message to an mqtt broker to receive relevant messages.

• header flags: holds information on the mqtt control packet type.
• message identifier: identifier between a client and a broker to identify a message in a message flow. this is more relevant for qos greater than zero.
• topic and qos level: each subscription is a pair of a topic filter and qos level. the topic is the subject of interest that the client would like to get messages on.
• payload: the payload contains a list of subscriptions. a payload is mandatory in a subscribe packet.

4. subscribe acknowledgement message

the mqtt broker confirms a subscription by sending an acknowledgment back to the client using a suback message.

• header flags: holds information on the mqtt control packet type.
• message identifier: relevant for a message with qos greater than zero and is the same as in the subscribe message.
• return code: the mqtt broker sends a return code for each topic/qos pair received in the subscribe message. the return code is in line with the qos level in case of success. return code values and responses are shown in the table below.

5. publish message

once an mqtt client is connected to the broker, it can publish messages.

• header flags: holds information on the mqtt control packet type.
• dup flag: when the dup flag is 0, it means this the first attempt at sending this publish packet. if the flag is 1, it indicates a possible re-attempt at sending the message.
• qos : the qos level determines the assurance level of a message.
• retain flag: if retain flag is set to 1, the server must store the message and its qos, so that it can cater to future subscriptions matching the topic. when a publish packet is sent to a subscribing client, the server must set the retain flag to 1 if the packet is sent because of a new subscription. the server must set the retain flag to 0 when the packet is sent because it matches an established subscription irrespective of whether the flag was set when the message was received.
• topic name: a utf-8 string which can also contain forward slashes when it needs to be hierarchically structured. a publish message must contain a topic which is used by the broker for subject based filtering. this way the broker will send messages to clients that have subscribed to the topic.
• message: message is the payload along with the topic which contains the actual data to be transmitted. since mqtt is data agnostic, the payload can be structured based on the use case.
• payload: the payload contains the message that is being published.

6. disconnect request message:

disconnect message is the final control packet sent by the client to the broker. it signifies a clean disconnection by the client.

• header flags: holds information on the mqtt control packet type.
• payload: the disconnect packet has no payload.

7. mqtt keep alive

keep alive functionality assures that connection is open and the client and the broker are connected to each other. when the connection is established the keep-alive time interval (in seconds) is communicated to the broker by the client.

mqtt specification says:

“it is the responsibility of the client to ensure that the interval between control packets being sent does not exceed the keep alive value. in the absence of sending any other control packets, the client must send a pingreq packet.”

the keep alive flow is maintained by pingreq and pingresp messages.

a typical keep alive flow looks like the image below:

pingreq

the pingreq is sent by the client to the broker to denote that it is still alive though it has not sent other mqtt control packets. if the broker does not receive a pingreq or any other packet, it will close the connection and send out the lwt message, provided the client has specified one.

• header flags: holds information on the mqtt control packet type.
• payload: the pingreq packet has no payload.

pingresp

the pingresp is the reply that the broker sends to the pingreq packet received. this indicates the broker’s availability to the client.

• header flags: holds information on the mqtt control packet type.
• payload: the pingresp packet has no payload.

conclusion

mqtt has spurred innovation in the iot landscape and has become an integral part of the digital world. the previous blog post on mqtt gave us an overview of the protocol, and, in this article, we discussed the different processes involved in the communication between an mqtt client and mqtt broker with the help of wireshark. understanding these metrics and the workflow will help you quickly identify mqtt related issues.