prometheus-hass-sun2k 0.2.0

Prometheus exporter for HomeAssistant data on Huawei SUN2000 inverters

📊🏠🔌☀ HomeAssistant Huawei SUN2000 Exporter

Prometheus exporter providing metrics from a HomeAssistant instance about a Huawei SUN2000 inverter.

Why?

• HomeAssistant's Prometheus integration is currently broken (see issue #80656 and issue #104803 for example).
• The SUN2000's TCP modbus interface can always just talk to one single client at a time, therefore using a direct modbus connection to the inverter would interfere with HomeAssistant's data scraping.
• HomeAssistant provides stats through its built-in API anyway, so let's use them.

Until there is a better solution, this workaround does the job.

⚙🔧 How? ⚙🔧

Example installation on Debian / Ubuntu:

### all commands run as "root" or using "sudo" ###

# required for creating Python virtualenvs:
apt update
apt install -y python3-venv

# create a virtualenv in /opt:
python3 -m venv /opt/prometheus-hass-sun2k

# update 'pip' and install the 'prometheus-hass-sun2k' package:
/opt/prometheus-hass-sun2k/bin/pip install --upgrade pip
/opt/prometheus-hass-sun2k/bin/pip install prometheus-hass-sun2k

🏃 Running in foreground mode 🏃

Create a configuration file by copying the config-example.yaml file to e.g. config.yaml and adjust the settings there. Then run the exporter (from within the activated venv or using the full path) like this:

prometheus-hass-sun2k -vvv --config config.yaml

The exporter running in foreground can be terminated as usual via Ctrl+C.

👟 Running as a service 👟

# create a system user for running the service:
adduser --system --group has2k-exporter

# copy the configuration example, adjust permissions and edit it:
cp -v /opt/prometheus-hass-sun2k/lib/python*/site-packages/prometheus_hass_sun2k/resources/config-example.yaml /opt/prometheus-hass-sun2k/config.yaml
chgrp has2k-exporter /opt/prometheus-hass-sun2k/config.yaml
chmod 640 /opt/prometheus-hass-sun2k/config.yaml
editor /opt/prometheus-hass-sun2k/config.yaml

# install, register and adjust the systemd unit file:
cp -v /opt/prometheus-hass-sun2k/lib/python*/site-packages/prometheus_hass_sun2k/resources/systemd/prometheus-hass-sun2k.service  /etc/systemd/system/
systemctl daemon-reload
systemctl edit prometheus-hass-sun2k.service

The last command will open an editor with the override configuration of the service's unit file. Check the values from the provided example script (e.g. paths) and adjust as necessary.

Finally enable the service and start it right away. The second line will show the log messages on the console until Ctrl+C is pressed. This way you should be able to tell if the service has started up properly and is providing metrics on the configured port:

systemctl enable --now prometheus-hass-sun2k.service
journalctl --follow --unit prometheus-hass-sun2k

🆙 Upgrading 🆙

Assuming the exporter has been installed as described above, an upgrade to a newer version could be done like this:

/opt/prometheus-hass-sun2k/bin/pip install --upgrade prometheus-hass-sun2k
# check the changelog for potentially new configuration settings, integrate them
# if necessary and finally restart the service:
systemctl restart prometheus-hass-sun2k.service