Easee prometheus exporter

Monitor your Easee EV charger with Prometheus and Grafana.

Description

This prometheus exporter will connect to the Easee cloud service, periodically fetch charger state and make the metrics available for Prometheus.

See the provided Grafana dashboard for examples on how they can be used.

Running

Docker image is available on ghcr.io.
Prebuilt binaries for Linux, MacOS and Windows are available on the release page.

Docker compose

If you don't already run Grafana and Prometheus, you can try a complete setup with docker compose.

cd docker-compose
EASEE_USERNAME=... EASEE_PASSWORD=... docker compose up

Then go to http://localhost:3000/ and find the dashboards in the General folder.

Kubernetes

Install in your kubernetes cluster with Helm. First add the the helm repository:

helm repo add easee-exporter https://terjesannum.github.io/easee-exporter/
helm repo update

Then install the helm chart:

helm install easee-exporter easee-exporter/easee-exporter --set-string username=... --set-string password=...

This with install the exporter with the prometheus.io/scrape annotation set to true. If you run the Prometheus operator, install with serviceMonitor.enabled=true to create a ServiceMonitor instead:

helm install easee-exporter easee-exporter/easee-exporter --set-string username=... --set-string password=... --set serviceMonitor.enabled=true

Docker container

docker run -d -p 8080:8080 -e EASEE_USERNAME=... -e EASEE_PASSWORD=... --restart always ghcr.io/terjesannum/easee-exporter:latest

Prometheus

Prometheus need to be configured to scrape the exporter, so add a scrape job to /etc/prometheus/prometheus.yml:

scrape_configs:

  - job_name: "easee-exporter"
    scrape_interval: 1m
    static_configs:
      - targets: ["localhost:8080"]

Grafana

Import the dashboard and select the Prometheus datasource that scrapes the exporter.