Updated readme
This commit is contained in:
parent
ad1bc1d2b4
commit
c307a90a15
57
README.md
57
README.md
|
@ -1 +1,56 @@
|
|||
# tasmota-power-exporter
|
||||
# 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](./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](./metrics.py).
|
||||
|
||||
## Contributors
|
||||
|
||||
- [Nathan Higley](https://github.com/astr0n8t)
|
Binary file not shown.
After Width: | Height: | Size: 130 KiB |
Loading…
Reference in New Issue