A simple and straightforward script for exposing OpenHAB 2 items as Prometheus metrics. Note that the steps below have been based on a Raspberry PI 2 with Raspbian installed.
- Python 3.5 or higher
- Gunicorn3
Typically you'd install this script on the same server that runs OpenHAB 2.
- Install
python3andgunicorn3packages. Make surepython3is version 3.5 or higher- You can check this by running
python3 --version
- You can check this by running
- Place
openhab2-exporter.pyin a directory of choice- For example in
/opt/openhab2-exporter
- For example in
- Save
openhab2-exporter.service.templateas/etc/systemd/system/openhab2-exporter.service- Open the file, and update the template:
- Change the listening port
99999to a port of your choice - If you chose to place the script in a different directory described in this doc,
modify the
WorkingDirectoryproperty accordingly
- Change the listening port
- Open the file, and update the template:
- Start the service
systemctl start openhab2-exporter.service
You can check if everything's working correctly by opening http://servername:port, where servername is the
name or ip of the server that runs the script, and port is the port you chose to run the service on. If all
went well you should see the raw metrics appear.
Also don't forget to add this location to your scrape targets in Prometheus!