# mqtt-exporter

> Self-hosted Prometheus exporter converting MQTT messages from IoT sensors into metrics for Zigbee2MQTT, Zwavejs2Mqtt, ESPHome, Hubitat, Meshtastic, and Shelly.

- **Category:** Monitoring & observability
- **Licence:** MIT
- **Latest version:** mqtt-exporter-0.1.4
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker, Docker Compose, Python
- **Tags:** Monitoring, Iot, Mqtt, Zwave, Home Assistant, Prometheus, Esphome, Meshtastic, Exporter, Shelly, Prometheus exporter, Zigbee2mqtt, Zwavejs2mqtt, Hubitat

## Description

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.

## Links

- [Homepage](https://github.com/kpetremann/mqtt-exporter)
- [Website](https://hub.docker.com/r/kpetrem/mqtt-exporter)
- [Docker](kpetrem/mqtt-exporter)
- [GitHub Repository](https://github.com/kpetremann/mqtt-exporter)
- [Docker Hub](https://hub.docker.com/r/kpetrem/mqtt-exporter)

---
Source: https://selfhost.directory/project/mqtt-exporter