lux4rd0 / sense-collector

Sense Collector provides a way of collecting real-time data from the Sense Energy Monitor. Includes Grafana dashboards for visualizations of detected devices and smart plugs and their wattage, voltage, and amp utilization.
https://labs.lux4rd0.com/sense-collector/
GNU Affero General Public License v3.0
26 stars 4 forks source link
dashboards docker energy-consumption energy-monitor grafana influxdb observability sense

Sense Collector

Sense Collector Header

Sense Collector is a Python-based application deployed via Docker that collects data from the Sense energy monitoring system. It enables real-time energy monitoring through a set of pre-built, configurable Grafana dashboards, giving you powerful insights into your energy consumption patterns.

Key Features

Quick Start Guide

To get up and running with Sense Collector, you will need to:

  1. Ensure you have Docker, Docker Compose, InfluxDB 2.x, and Grafana installed.
  2. Pull the latest Sense Collector Docker image.
  3. Configure your environment variables for Sense API credentials and InfluxDB connection.

For complete setup instructions, including all the necessary environment variables and deployment configurations, please visit the Wiki.

Dashboards

Sense Collector includes several Grafana dashboards to help you monitor your energy usage:

You can find detailed instructions on setting up and customizing these dashboards in the Grafana Dashboards section of the Wiki.

Configuration

Sense Collector uses a set of environment variables to control its behavior and integrate with the Sense API and InfluxDB. These variables must be configured before deploying the container. For a full list of required and optional variables, visit the Environment Variables page.

Support & Contact

If you have any questions or need support, feel free to reach out:

Project Link: https://github.com/lux4rd0/sense-collector

Acknowledgements