A Prometheus exporter for Tasmota smart plugs.

Go to file

Nick Trimborn ed97c06180 Docker Push / build (push) Successful in 42s Details updated dashboard		2023-07-21 11:21:06 +02:00
.github/workflows	updated workflow	2023-07-20 11:16:49 +02:00
.gitignore	Able to scrape	2022-01-14 13:56:41 -05:00
Dockerfile	Update Dockerfile	2022-11-23 16:12:19 -05:00
LICENSE	Initial commit	2022-01-14 13:02:01 -05:00
README.md	Updated readme	2022-04-24 18:04:40 -04:00
grafana.json	updated dashboard	2023-07-21 11:21:06 +02:00
grafana.png	Updated readme	2022-04-24 18:04:40 -04:00
metrics.py	Update metrics.py	2023-07-20 13:32:20 +00:00
requirements.txt	updated to match fork	2023-07-20 13:07:41 +02:00

README.md

Tasmota Power Exporter

A custom exporter for Prometheus for the Tasmota open source smart plug firmware.

Allows you to collect metrics directly from individual smart plugs without the use of HomeAssistant or something similar.

Grafana Dashboard

Available in grafana.json

Deployment

The GitHub actions pipeline automatically builds Docker images for ARM and x86 devices for simplified deployment.

Docker-Compose:

  tasmota:
    image: ghcr.io/astr0n8t/tasmota-power-exporter:latest
    container_name: tasmota-power
    restart: always
    ports:
    - 8000:8000
    environment:
    - DEVICE_IP=<Tasmota IP>
    - USER=<user>
    - PASSWORD=<password>

Prometheus Config:

- job_name: "tasmota"

    # metrics_path defaults to '/metrics'
    # scheme defaults to 'http'.

    static_configs:
        - targets: ["127.0.0.1:8000"]

Development

Perform the following:

git clone https://github.com/astr0n8t/tasmota-power-exporter.git
cd tasmota-power-exporter
pip install -r requirements.txt

All of the exporter code is found in metrics.py.

Contributors

Nathan Higley