Skip to main content
Version: Mosquitto 3.0

Client Inspection

The client inspection is part of the broker. It allows you to find out, which clients are or were connected to a broker and get several metrics of and infos about the connected clients.

You need to activate Client Inspection before it can be used.

Plugin activation

To enable the plugin on the broker, add the following to the mosquitto.conf file:

Client Inspection

plugin /usr/lib/cedalo_inspect.so
plugin_opt_disconnected_clients_ttl 300

Client Control

plugin /usr/lib/cedalo_client_control.so

Configuration

To interact with the plugin use the available MQTT API for Inspection and Inspection. Make sure the interacting client has enough rights to publish to the needed topics or use the Platform UI.

View Client Infos in the Cedalo MQTT Platform

The client connection of the Cedalo MQTT Platform page gives you a visual overview of all recently connected clients. To view these, navigate to the project of the broker and then to the broker management. Here you select "Connected Clients" from the navigation. Then the Connected Clients page is opened displaying a table with all connected clients like below.

For each connected client, the following infos are displayed.

  • The Client ID. The client id is either provided, when the client is explicitly defined or created automatically.
  • Name of the client.
  • Connection state
  • Last connection date and time
  • The IP Address, where the client is running or has connecting from.
  • The MQTT protocol the client is using to connect to the broker.
  • The Queue Usage. Messages can be buffered, if delivering is interrupted to a certain limit. Here you can observe, if messages are buffered or queued and see the maximum queue size. If the size limit is reached, messages are discarded.
  • Option to disconnect a client explicitly. To disconnect, simply click on the icon at within the Disconnect column.

If you click on the arrow left to the Client ID more detailed infos related to the client are displayed in different sections. Not all sections are visible at once, so have to scroll down to view all details.

Besides client connection general and detail infos, you can view detailed metrics related to message exchange. Please also observe that you can view all topics, that the client has subscribed to.