Self-host mqtt-exporter
mqtt-exporter-0.1.4Generic Prometheus exporter for MQTT IoT devices
- Stars
- 168
- Port
- 9000 (Prometheus metrics HTTP endpoint)
- Requires
- MQTT Broker
kpetrem/mqtt-exporterWhat is mqtt-exporter?
MQTT-exporter is a lightweight Prometheus exporter that subscribes to MQTT topics and converts JSON or numeric payloads into Prometheus metrics. It works with popular IoT ecosystems including Zigbee2MQTT, Zwavejs2Mqtt, ESPHome, Hubitat, Meshtastic, and Shelly devices. The exporter runs as a Docker container or Python application, exposing metrics on port 9000. It supports TLS for MQTT and Prometheus endpoints, topic filtering, metric prefix customization, and device availability normalization for Zigbee2MQTT. Configuration is done entirely through environment variables. The project is actively maintained with recent releases.
Should you self-host mqtt-exporter?
mqtt-exporter scores 48/100 on selfhost.directory (how scoring works) and ranks #67 of 104 in Monitoring & observability. It has 168 GitHub stars.
It shipped 6 stable releases in the past year. The latest, mqtt-exporter-0.1.4, came out on 11 May 2026. New versions land roughly every 9 days.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is grafana (90/100, 77 569 stars). It scores higher overall, so compare the two before you pick. See mqtt-exporter vs grafana side by side.
Features
- Configurable metric prefix and labels
- Custom state value mappings
- ESPHome support
- Hubitat support
- Meshtastic support
- Message Counters
- Metric expiration/TTL
- Prometheus metrics from MQTT
- Shelly support
- TLS support for MQTT and Prometheus
- Topic filtering
- Zigbee2MQTT support
- Zwavejs2Mqtt support
mqtt-exporter README
More in Monitoring & observability
onWatchSelf-hosted AI quota monitor for 16 providers. Lightweight Go binary with SQLite and Material dashboard showing live countdowns and burn-rate forecasts — zero telemetry.
openreplaySession replay, cobrowsing and product analytics you can self-host. Best for reproducing issues and iterating on your product.
openstatusOpen-source uptime monitoring, status pages and incident response: declare checks and pages in YAML or Terraform, run private probes, self-host with Docker.
Operational.coOperational - open-source tool to track important events and receive push notifications on your device.
Percona Monitoring and Management (PMM)Self-hosted open-source database observability platform with query analytics, dashboards, advisors, alerting, and backup for major databases.
phpsysinfoSystem information viewer in PHP showing hardware, memory, filesystem, network, temperature, fan, and power data across Linux, Windows, macOS, BSD platforms.
rpi-mqtt-monitorSelf-hosted system monitor for Raspberry Pi and Linux publishing metrics to Home Assistant via MQTT with zero-config auto-discovery.
scanopyNetwork diagrams that update themselves
Self-Hosted Metrics (SHM)Self-hosted telemetry server collecting aggregate metrics from distributed apps without user data. Features cryptographic identity, dynamic dashboards, Go/Node.js SDKs.
signozOpen-source observability tool you host yourself, combining APM, logs, traces, and dashboards on OpenTelemetry to replace DataDog.
simonSimon is a self-hosted, open-source system monitor in Rust with real-time metrics, Docker monitoring, file browser, and alerting via webhooks — all in a single binary.
smartctl_exporterSelf-hosted, open-source Prometheus exporter that collects SMART disk health data via smartctl and exposes it as metrics for monitoring storage hardware.
0 comments