MQTT data source
The MQTT data source plugin connects Grafana to an MQTT broker, letting you stream messages from MQTT topics directly into dashboard panels in real time. It’s well suited for IoT monitoring, sensor data visualization, and any scenario where you need live data pushed from devices or services.
Note
This plugin streams live data only. It doesn’t store messages or provide access to historical data. If you need to query past events, use a storage backend such as Loki or InfluxDB to persist messages received from MQTT.
Supported features
The following table lists the features supported by the MQTT data source.
Requirements
Before you set up the MQTT data source, you need:
- Grafana version: Grafana 11.0.0 or later.
- MQTT broker: A running MQTT v3.1.x broker accessible from the Grafana server.
- Grafana permissions: Organization administrator role. Refer to Permissions for details.
Get started
The following pages help you set up and use the MQTT data source:
- Configure the MQTT data source – Set up the connection, authentication, and TLS.
- MQTT query editor – Subscribe to topics and understand how data is formatted.
- Template variables – Create dynamic dashboards with variable-driven topics.
- Troubleshoot MQTT data source issues – Resolve common connection, authentication, and query problems.
Known limitations
- The plugin supports MQTT v3.1.x only. MQTT v5 isn’t supported.
- Supported connection schemes are
tcp://,tls://,ws://, andwss://. The aliasesmqtt://(same astcp://),ssl://,tcps://, andmqtts://(same astls://) are also accepted. - Not all MQTT CONNECT packet options are available for configuration.
- All subscriptions use QoS 0 (at most once delivery).
- There’s no historical data support. Panels only display data received while they’re open.
- Timestamps are attached when messages arrive at Grafana, not extracted from message payloads. Use the Convert field type transformation to parse timestamps embedded in messages.
Plugin updates
Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.
Note
Plugins are automatically updated in Grafana Cloud.
