Sparkplug InfluxDB Extension for HiveMQ

Monitoring of IIoT data

Category: Monitoring
License: Apache
Provider: HiveMQ    |   Verified: yes

Product Resources
Please use the following links to download and try the extension, read the installation guide, learn more about features, or find out how we can help.


The HiveMQ Sparkplug Extension can be leveraged to gather MQTT Sparkplug metrics from HiveMQ and persist them into a InfluxDB database. This database can be used as the data source for a monitoring dashboard to monitor directly the data from the devices and gateways of a Sparkplug Infrastructure.

This extension is not yet ready for production use.

If you want to use this in production, please contact HiveMQ


Sparkplug Extension Flow


Installing the extension for HiveMQ is very easy:

  1. Unzip the downloaded zip file
  2. In the folder hivemq-sparkplug-extension, modify the file to fit your needs. Check that the mandatory properties from influxDB (host, port) are set
  3. Copy the folder hivemq-sparkplug-extension to your [HIVEMQ_HOME]/extensions folder
  4. Done


The Sparkplug Monitoring extension uses its own configuration file The extension won’t start if this file is missing or the required properties are not set.


2 InfluxDB example dashboards are provided in the deploy subfolder of this extension.

Influx dashboard Description
HiveMQInfluxDB-Dashboard.json HiveMQ dashboard with the most useful hivemq metrics
SparkplugInfluxDB-Dashboard.json Sparkplug example dashboard, that vizualizes data of 2 edge nodes and their related devices.

Sparkplug Dashboard

General Configuration

Config name Required Description Default
influxdb.mode no The mode configured for the InfluxDB sender. Possibilities are: http, tcp, udp, cloud http yes The host name of the InfluxDB instance.
influxdb.port yes The port number the InfluxDB instance is listening. 8086
influxdb.protocol no The protocol the InfluxDB sender uses in http mode. http
influxdb.auth no The authorization string to be used to connect to InfluxDB, of format username:password. If mode “cloud” is used, the token must be passed here
influxdb.prefix no The measurement prefix.
influxdb.database no The database name. hivemq
influxdb.reportingInterval no The reporting interval in seconds. 1
influxdb.connectTimeout no The connect and read timeout in seconds. 5000
influxdb.tags no The tags for each metric. Listed as a semicolon ( ; ) separated list.
influxdb.organization only for mode: “cloud” The organization to push data to
influxdb.bucket only for mode: “cloud” The bucket to push data to
sparkplug.version no The sparkplug version to be used spBv1.0

Example Configuration to connect to a local influxdb 2.0

influxdb.auth:<your token>

influxdb.organization:<your company>



First Steps

Quick Start Sparkplug

InfluxDB setup

If you don’t already have an InfluxDB 2.0 instance set up, here is an instruction how to start and configure an InfluxDB instance with Docker.

Sparkplug setup

The Extensions actual supports the Sparkplug B specification for a payload. The sparkplug schema is defined with protobuf.


After the extension is installed and an InfluxDB instance exists.

Example deployment

For testing purposes a simple HiveMQ docker file with the sparkplug extension, and a compose file for influxDB setup is available in the deploy/docker subfolder. Further a Kubernetes script for deploying hivemq with sparkplug extension setup in Kuberntes is available in the deploy/k8s

Influx Dashboard

An influx dashboard example SparkplugInfluxDB-Dashboard.json is available in the deploy subfolder. The dashboard contains diagrams to monitor the Sparkplug online status of edge nodes and devices. It also gathered the sparkplug data values from the example devices.


If you want to contribute to HiveMQ Sparkplug Extension, see the Contribution Guidelines.


HiveMQ Sparkplug Extension is licensed under the APACHE LICENSE, VERSION 2.0. A copy of the license can be found here.

Need Help?

We're always happy to answer any questions you may have during installation. The best place to get in contact is our community forum.

Contact Sales

If you have any questions about this product or any others, please contact our sales team here.

Back to marketplace