1
0
Fork 0
mirror of https://github.com/Luzifer/mqtt2influx.git synced 2024-10-18 05:44:19 +00:00

Add more info to README

Signed-off-by: Knut Ahlers <knut@ahlers.me>
This commit is contained in:
Knut Ahlers 2020-07-11 20:04:07 +02:00
parent ecc9f53bbf
commit b265cf072e
Signed by: luzifer
GPG key ID: DC2729FDD34BE99E

View file

@ -1,5 +1,9 @@
# Luzifer / mqtt2influx
MQTT to InfluxDB transport
MQTT to InfluxDB transport: uses mapping config including transformer functions to pull data from MQTT topics and write those values into InfluxDB.
Uses mapping config including transformer functions to pull data from MQTT topics and write those values into InfluxDB
The motivation behind this was for me to have a lot of [Tasmota](https://tasmota.github.io/docs/) sensors sending data through MQTT to [Home-Assistant](https://www.home-assistant.io/). Home-Assistant is capable of writing those metrics into InfluxDB but sadly it only writes them on change. So if a value does not change for an extended period of time for example Grafana dashboards will stop to display the metric as it contains no data.
As those sensors are sending values in different forms (value only, value embedded in JSON, ...) I needed a way to configure the transform of the values in a way no code needs to change for a new transmission method. Therefore I came to use Python with extra support for lambda functions in the configuration.
**A word of warning:** If you plan to run this in an untrusted environment you will compromise your environment! Lambda functions in config which execute code on random values sent through MQTT aren't a good idea. So only use them if you are 110% sure you only will get the expected values / data in a fully trusted environment!