Netatmo Energy Exporter

This Prometheus exporter works with the netatmo energy API. It reads the current temperature measurement and set point temperature and exports it in prometheus readable way alongside with other metrics. This exporter publishes metrics per room and per modules.

IMPORTANT: this exporter works only with netatmo Thermostats and Valves.

---

Fix for the failure after the server is stopped and relaunched (if compiled)

This exporter creates a netatmo_token.json file to store the access token, refresh token, and expiration date. If the server stops, it reloads these credentials from the file on relaunch, avoiding the error: failed to refresh token, status: 400, body: {"error":"invalid_grant"}

Prerequisites

1. Install Go on your machine if not already installed.
2. Go to the Netatmo Developer Portal and:
   • Create a new app.
   • Add token credentials for read_thermostat.
   • Copy the generated Refresh Token.

Installation

1. Clone the repository:

   git clone https://github.com/giuliomagnifico/netatmo_energy_exporter
   

Navigate to the project folder:

cd netatmo_energy_exporter

Compile the exporter. For example, for ARM (Raspberry Pi): GOARCH=arm64 GOOS=linux go build -o netatmo_energy_exporter

Usage

Write the Refresh Token to the netatmo_token.json in raw format, without quotes or anything else, just the text, like this: 123456|789123

Run the exporter with your credentials. Example:

./netatmo_energy_exporter --client-id 123456789 --client-secret 987654321 --listen 0.0.0.0:2112

(--listen is optional and can be used to specify a different port)

Notes

It will save the access token, refresh token, and expiry date to netatmo_token.json, and it will be automatically renewed. Example:

{"access_token":"12345|54321","refresh_token":"67890|09876","expiry":"2024-12-07T18:29:27.981698608+01:00"}