Skip to content

ccremer/stiebeleltron-exporter

Repository files navigation

Stiebel-Eltron Exporter

Build Maintainability Tests Releases License

About

Scrapes a Stiebel-Eltron ISG installation and converts sensor data to Prometheus metrics. It has been tested with ISG 10.2.0.

Installing

Binary

  1. Download latest binary from the Releases page

  2. chmod +x stiebeleltron-exporter && mv stiebeleltron-exporter /usr/local/bin/

Package

Comes with systemd unit file.

  1. Download latest package from the Releases page

  2. dpkg -i stiebeleltron-exporter_linux_amd64.deb (Debian/Ubuntu)

  3. rpm -i stiebeleltron-exporter_linux_amd64.rpm (CentOS)

  4. sudo systemctl daemon-reload

  5. Edit the settings in /etc/default/stiebeleltron-exporter

  6. sudo systemctl enable stiebeleltron-exporter

  7. sudo systemctl restart stiebeleltron-exporter

Docker

  1. docker run -d --name stiebeleltron-exporter -p "8080:8080" ghcr.io/ccremer/stiebeleltron-exporter

Helm Chart

  1. helm repo add ccremer https://ccremer.github.io/charts

  2. helm install stiebeleltron ccremer/stiebeleltron-exporter

Usage

stiebeleltron-exporter --isg.url http://isg.ip.or.hostname

Upon each call to /metrics, the exporter will do GET requests on the given URL, and translate the HTML responses to Prometheus metrics format.

Configuration

stiebeleltron-exporter can be configured with CLI flags. Call the binary with --help to get a list of options.

💡
All flags are also configurable with Environment variables. Replace the . char with _ and uppercase the names in order for them to be recognized, e.g. --log.level debug becomes LOG_LEVEL=debug. CLI flags take precedence though.

Developing

Requirements:

  • Go

make help shows a list of possible tasks.