🌐 Eero Prometheus Exporter

Keep an eye on your mesh network like never before

A modern, async, strictly read-only Prometheus exporter for your eero mesh WiFi network.
Network health, every eero and radio, client devices, data usage, entitlements -- 197 metrics.

Get Started · Metrics · Docker · Documentation

⚠️ Upgrading from 3.x? 4.0.0 is a breaking release

Requires eero-api 8.x. 3.x installs stopped working when eero-api 8.0.0 was published; 4.0.0 pins >=8.0.2,<9 and builds images from the lock file.

36 metrics were removed (they never had an API source) and eero_exporter_api_requests_total{status} is now a closed enum -- see Removed in 4.0.0.

The session file is rewritten to a new format on first use and 3.x cannot read it back. Back it up first; the config directory must be writable (containers: mount the directory read-write).

--data-usage became --include-data-usage; --config is kept as an alias of --config-file; --include-diagnostics is gone.

Upgrade and rollback steps: Installation → Upgrading from 3.x.

📸 Dashboard Preview

Grafana Dashboard

Eero Mesh Network Grafana Dashboard - network status, eero and radio health, devices, usage and entitlements

✨ What You Get

Feature	Description
📊 197 metrics, tiered	`core`, `extended` and `rf` on by default (29 API requests per cycle); `per-profile`, `per-device`, `per-eero` and `unverified` opt-in. Every metric documents its API source path and evidence level.
🔒 Strictly read-only	Every data operation is a GET: the exporter never creates, changes or deletes anything on your network. The only POSTs are authentication -- `login`/`verify`, plus the SDK's own transparent session refresh. Enforced by a surface test against the real SDK and a write guard in the test suite.
🌐 Network & radios	Health, ISP state, speed test, DNS/DHCP/WAN modes, 119 capability flags, per-band channel, width, TX power and utilisation on every eero.
📱 Devices & profiles	Connection quality, PHY rates, MCS/NSS, packet statistics, data usage per device, eero and profile.
💎 eero Plus / Secure	Entitlements, DNS policies, insights, WPA3 per band, permissions, subnets, notifications.
🩺 Observable errors	`eero_exporter_api_requests_total{endpoint,status}` with a closed `status` enum: `premium_required`, `feature_unavailable` and `not_found` are expected states, not failures.
⚙️ Configure anywhere	Every flag of every command has an `EERO_EXPORTER_*` environment variable; `serve`'s options also have YAML keys. Precedence CLI > env > YAML > default.
🔐 Browser login	Optional `/auth` page (shared secret, CSRF, rate limit) to sign in without shell access -- handy for containers.
🔎 Read-only probe	`eero-exporter probe` captures redacted API shapes for bug reports and new metrics.
🐳 Docker ready	Non-root image built from `uv.lock`; `latest` only moves on releases.

🚀 Quick Start

pip install eero-prometheus-exporter
eero-exporter login your-email@example.com   # identifier -> verification code
eero-exporter serve

Metrics live at http://localhost:10052/metrics. Configure with flags, EERO_EXPORTER_* environment variables or ~/.config/eero-exporter/config.yml:

EERO_EXPORTER_INTERVAL=120 EERO_EXPORTER_INCLUDE_PER_EERO=true eero-exporter serve

📚 Documentation

Full documentation in the Wiki — Installation · Docker · CLI · Configuration · Metrics · Security · Troubleshooting

📄 License

MIT — Use it, fork it, build cool stuff 🎉

📊 Repository Metrics

Repository Metrics

Metadata

Release files for eero-prometheus-exporter 4.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eero-prometheus-exporter 4.0.1
File	Size	Uploaded
eero_prometheus_exporter-4.0.1.tar.gz	177.8 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for eero-prometheus-exporter 4.0.1
File	Interpreter	ABI	Platform	Reset
eero_prometheus_exporter-4.0.1-py3-none-any.whl 109.1 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 286.9 kB

Release files / eero_prometheus_exporter-4.0.1.tar.gz

Download URL	eero_prometheus_exporter-4.0.1.tar.gz
Size	177.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`ec75581aaf34c1d6597a643e5edb87b6f6edceab7aefb8f0e66b950e22dbea8f`
BLAKE2b-256 checksum How to use checksums	`ff59565aa3bbe81c3dd4cc8a8a99b1996657bfc138f9ce92347dec3054d732ac`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / eero_prometheus_exporter-4.0.1-py3-none-any.whl

Download URL	eero_prometheus_exporter-4.0.1-py3-none-any.whl
Size	109.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a987e976721ccc382f3b64e562ea92155f3f2fe608d873d6568b64b82578478b`
BLAKE2b-256 checksum How to use checksums	`18b32691ea76ec141c2da76e19d07ab44aa1bcbcde2ad820fd0c5a26a185297f`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`