feat: multi-device support, active data polling, bundled Grafana dashboard, nginx proxy #82
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
DEVICE_SN and DEVICE_NAME now accept comma-separated values to monitor multiple EcoFlow devices from a single exporter instance. Each device gets its own MQTT connection and worker thread, sharing a single Prometheus HTTP endpoint via thread-safe gauge registry. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Process(target=self.connect) fails on macOS (and Python 3.13+ with spawn start method) because Queue contains _thread.lock objects that cannot be pickled. Using a daemon Thread with join(timeout=60) provides the same timeout safety without serialization issues. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
EcoFlow devices do not push MQTT data autonomously — they require a latestQuotas request to respond with current metrics. This adds a periodic request every 15 seconds to keep data flowing without needing the mobile app open. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Fork dashboard 17812 into repo with auto-provisioning via compose. Added collapsed "Extra Battery" row with 11 panels for bms_slave metrics. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Restrict prometheus/alertmanager/exporter ports to 127.0.0.1 - Add optional nginx service via Docker Compose profile - Include configs for Cloudflare and Let's Encrypt scenarios - Document three deployment options in README Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds several improvements developed while running the exporter with two EcoFlow DELTA 2 devices on a home setup.
Monitor multiple EcoFlow devices from a single exporter instance using comma-separated environment variables:
DEVICE_SN=SN1,SN2
DEVICE_NAME=delta-kitchen,delta-livingroom
The previous implementation used multiprocessing.Process to handle reconnection. This fails on systems using the "spawn" start method (macOS, and optionally Linux) because Queue contains thread locks that can't be pickled. Replaced with
threading.Thread(daemon=True) which is also simpler and more portable.
EcoFlow devices do not push telemetry data autonomously — they only respond when the mobile app is active. Added periodic publish to /app/{user_id}/{device_sn}/thing/property/get with operateType: latestQuotas every 15 seconds. This keeps
metrics flowing without requiring the official app to be open.
Optional nginx service via Docker Compose profile for hosting behind a domain:
docker compose --profile nginx up -d
Includes configs for both Cloudflare and Let's Encrypt scenarios. Internal services (Prometheus, Alertmanager, exporter) are bound to 127.0.0.1 only.
Note for maintainer: compose.yaml currently has build: .. instead of image: ghcr.io/berezhinskiy/ecoflow_exporter — please revert that line after merging if you publish a new image build.