eero-exporter

eero-exporter is a Prometheus exporter for your personal eero kit. This is a basic implementation, but far more information can be retrieved using the 343max/eero-client library.

# HELP eero_speed_upload_mbps Current service response upload (Mbps)
# TYPE eero_speed_upload_mbps gauge
eero_speed_upload_mbps{id="1234567"} 10.025496
# HELP eero_speed_download_mbps Current service response download (Mbps)
# TYPE eero_speed_download_mbps gauge
eero_speed_download_mbps{id="1234567"} 113.158512
# HELP eero_health_status Current connection status
# TYPE eero_health_status gauge
eero_health_status{source="internet",id="1234567"} 1.0
eero_health_status{source="eero_network",id="1234567"} 1.0
# HELP eero_clients_count Current count of clients
# TYPE eero_clients_count gauge
eero_clients_count{id="1234567"} 12.0

Installation

Download the source from Github.

Install the necessary libraries in your virtualenv

pip install -r requirements.txt

Before running the eero exporter, you must first populate the session token. It is currently blank in session.yml. Running the initialise script will request eero account information.

$ python3 session_init.py
your eero login (email address or phone number): <account information here>
verification key from email or SMS: <one time password here>
Session key stored in session.yml

After you enter that, check your email or SMS for the one time password, and enter on the command line.

You can review session.yml to verify the token is set.

Usage

The exporter has one argument, the port. The default port is 9118.

python eero_exporter.py -port 9118

Docker

Please see acaranta's repo for instructions to run via Docker. Thank you, acaranta!

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Thank you

Thank you to 343max for providing the excellent eero client library.

License

Apache 2.0