https://github.com/jonfairbanks/emeter
Publish kasa plug metrics to Influx Cloud
https://github.com/jonfairbanks/emeter
influxdb kasa kasa-api metrics metrics-exporter
Last synced: 4 months ago
JSON representation
Publish kasa plug metrics to Influx Cloud
- Host: GitHub
- URL: https://github.com/jonfairbanks/emeter
- Owner: jonfairbanks
- Created: 2022-04-16T06:12:08.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-09T23:15:36.000Z (over 2 years ago)
- Last Synced: 2025-01-11T01:32:23.632Z (5 months ago)
- Topics: influxdb, kasa, kasa-api, metrics, metrics-exporter
- Language: Python
- Homepage: https://hub.docker.com/r/jonfairbanks/emeter
- Size: 2.26 MB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# emeter
Publish Kasa plug metrics to Influx Cloud
### Setup
- Setup your [Kasa smart plug](https://amzn.to/3JVZXzh) in the Kasa Home app
- Gather the IP address associated with your plug
- [Create a free Influx Cloud account](https://cloud2.influxdata.com/signup)
- Create an Influx Cloud Bucket (power-usage) and API Token
### Usage
The following env variables are **required**:
- INFLUX_TOKEN: API Token provided by Influx Cloud
- INFLUX_ORG: Your Influx Cloud organization name
- INFLUX_BUCKET: Your Influx Cloud bucket name (Default: `power-usage`)
- PLUG: IP Address of the Kasa plug to monitor
Additional supported env variables include:
- DEBUG: Enable or disable in-app debug logging (Default: `False`)
- DEVICE: Preferred name for this device (Default: `My Device`)
- INFLUX_HOST: Host of the Influx Cloud bucket (Default: `https://us-central1-1.gcp.cloud2.influxdata.com`)
### Launch
The application can be launched with `docker-compose`:
```
docker-compose up -d
```
### Dashboard
A sample dashboard is provided in this repo and can be imported:
- Ensure that emeter is running
- Login to Influx Cloud and go to Dashboards
- Use the dropdown on `Create Dashboard` to import the template