Skip to content

Svedrin/mqtt-pushgateway

Repository files navigation

Prometheus Exporter for metrics received via MQTT

This exporter provides a push gateway for MQTT: You let it listen to some interesting MQTT topics, it collects data into metrics and waits to be scraped by Prometheus.

Messages that can be parsed as JSON will log a unique metric per key:value pair using a 'virtual' topic of topic/key.

Caveat: Only float values are supported. Anything else will be ignored.

Features

  • Topics can be matched against a set of regular expressions to convert parts of their names into Prometheus keywords. Thus, a topic name such as

    sensor/garage/temperature
    

    when matched using regex

    sensor/(?P<sensor_name>\w+)/(?P<__metric__>\w+)
    

    would be exported to Prometheus as metric

    temperature{mqtt_topic="sensor/garage/temperature",sensor_name="garage"} 29.3
    
  • Each metric is accompanied by an mqtt_data_age metric, that tells us when the last update occurred:

    mqtt_data_age{mqtt_topic="sensor/garage/temperature",sensor_name="garage",metric="temperature"} 7
    

    By setting a threshold on this value, you can detect and alert on sensors being broken somehow and not sending updates anymore.

  • Allows metrics to expire if we don't get updates for a while. When a metric expires, its value won't be exported anymore, but data_age will continue to be exported. Thus, you can expire a metric after 2 minutes, but only after 5 minutes send an alert.

    Each Topic can have an individual expiry configuration.

  • Topics that were matched in a subscription pattern can be hidden from the result through a topic configuration.

  • JSON messages record each key:value pair as a unique metric, eg: the following payload sent on topic zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM:

    {"temperature":29.02,"linkquality":34,"humidity":55.58,"battery":100,"voltage":3005,"status":"online"}
    

    would expose the following metrics:

    temperature{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/temperature"} 29.020000
    linkquality{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/linkquality"} 34.000000
    humidity{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/humidity"} 55.580000
    battery{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/battery"} 100.000000
    voltage{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/voltage"} 3005.000000
    status{mqtt_topic="zigbee2mqtt/sensor/lounge/xiaomi/WSDCGQ01LM/status",status="online"} 1.0
    

Installation

  • apt-get install python3-pytoml python3-paho-mqtt python3-flask.
  • Copy config.example.toml to config.toml and adapt it to your needs.
  • Run mqtt_pushgateway.py. (See mqtt-pushgateway.service)

Docker

You can also use Docker:

  • docker run -d --name mqtt-pushgw -p 9466:9466 -v config.toml:/config/config.toml svedrin/mqtt-pushgateway:latest

About

Prometheus Exporter for metrics received via MQTT

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •