Mqtt-exporter

MQTT Exporter is a simple, generic Prometheus exporter for MQTT that turns numeric message payloads into metrics, letting you monitor IoT sensors and…

  • Monitoring & Logging
  • Network Services
  • Tools & Utilities
MQTT Exporter is a simple, generic Prometheus exporter for MQTT that turns numeric message payloads into metrics, letting you monitor IoT sensors and smart-home devices in a Prometheus/Grafana stack out of the box.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

57/100 Fair

Maintained
56last commit 194 days ago
Popular
45168 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
168
Open issues
2
Last commit
2026-05-11
Latest release
v1.11.2
License
MIT
Activity
stale

Checked 20 days ago - source: GitHub (kpetremann/mqtt-exporter)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup Point it at your MQTT broker (default is localhost) and a target topic; payloads must be flat JSON with numeric values. By default it exposes up to 2000 metrics, adjustable via the MAX_METRICS setting. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I point the exporter at an MQTT broker that is not on localhost?

You specify the MQTT target if the broker is not on localhost.

Do I need to configure metric parsing for basic MQTT messages?

It exposes metrics from MQTT messages out of the box.

What MQTT broker and sensor setup is tested?

It is tested with Mosquitto MQTT and Xiaomi sensors.

Can it be installed from Docker Hub or Unraid?

It is installable on Docker Hub and Unraid.

Answers sourced from github.com, ourlocalhost.com

Community

Collected 48 days ago - public community threads