Find a file
2021-12-23 16:46:18 +01:00
.github/workflows Update go-release action to a version 2021-11-15 16:02:40 +01:00
pkg put the scraping in own package 2021-12-23 16:36:04 +01:00
.gitignore Add builds for arm/arm64 2021-11-12 12:03:22 +01:00
Dockerfile Add dockerfile 2021-03-18 20:57:37 +01:00
go.mod switch to prometheus logging lib and write startup msg 2021-12-23 15:31:30 +01:00
go.sum switch to prometheus logging lib and write startup msg 2021-12-23 15:31:30 +01:00
LICENSE first commit 2021-03-18 15:37:44 +01:00
main.go use stringer to generate enum type 2021-12-23 16:46:18 +01:00
Makefile use stringer to generate enum type 2021-12-23 16:46:18 +01:00
README.md put the scraping in own package 2021-12-23 16:36:04 +01:00

myStrom prometheus exporter

Export myStrom WiFi Switch report statistics to Prometheus.

Metrics are retrieved using the switch REST api. This has only be testet using a WiFi switch with firmware 3.82.60, but should be backwards compatible with all 3.x firmwares.

To run it:

$ go build
$ ./mystrom-exporter [flags]

Exported Metrics

Metric Description
mystrom_up Was the last REST api call to the switch successful
mystrom_report_watt_per_sec The average of energy consumed per second from last call this request
mystrom_report_temperatur The currently measured temperature by the switch. (Might initially be wrong, but will automatically correct itself over the span of a few hours)
mystrom_report_relay The current state of the relay (wether or not the relay is currently turned on)
mystrom_report_power The current power consumed by devices attached to the switch

Flags

$ ./mystrom-exporter --help
Flag Description Default
web.listen-address Address to listen on :9452
web.metrics-path Path under which to expose exporters own metrics /metrics
web.device-path Path under which the metrics of the devices are fetched /device

Prometheus configuration

A enhancement has been made to have only one exporter which can scrape multiple devices. This is configured in Prometheus as follows assuming we have 4 mystrom devices and the exporter is running locally on the smae machine as the Prometheus.

 - job_name: mystrom
   scrape_interval: 30s
   metrics_path: /device
   honor_labels: true
   static_configs:
   - targets:
     - '192.168.105.11'
     - '192.168.105.12'
     - '192.168.105.13'
     - '192.168.105.14'
   relabel_configs:
     - source_labels: [__address__]
       target_label: __param_target
     - target_label: __address__
       replacement: 127.0.0.1:9452

Supported architectures

Using the make file, you can easily build for the following architectures, those can also be considered the tested ones:

OS Arch
Linux amd64
Linux arm64
Linux arm
Mac amd64
Mac arm64

Since go is cross compatible with windows, and mac arm as well, you should be able to build the binary for those as well, but they aren't tested.
The docker image is only built & tested for amd64.

Packages

Packages are built automatically on release, and container images on push to the main branch.

Take a look at the Releases or Packages tabs on Github.

Container images

There is a multiplatform build available here https://github.com/peschmae/exporter-go-mystrom/pkgs/container/exporter-go-mystrom

docker pull ghcr.io/peschmae/exporter-go-mystrom:latest

License

MIT License, See the included LICENSE file for terms and conditions.