Go to file
Mathias Petermann 2e0b079654
Update go-release action to a version
2021-11-15 16:02:40 +01:00
.github/workflows Update go-release action to a version 2021-11-15 16:02:40 +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
LICENSE first commit 2021-03-18 15:37:44 +01:00
Makefile Add builds for arm/arm64 2021-11-12 12:03:22 +01:00
README.md Update README 2021-11-12 15:34:41 +01:00
go.mod first commit 2021-03-18 15:37:44 +01:00
go.sum first commit 2021-03-18 15:37:44 +01:00
main.go Improve logging, show usage if flag is missing 2021-11-12 14:23:12 +01:00

README.md

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
switch.ip-address IP address of the switch you try to monitor ``
web.listen-address Address to listen on :9452
web.metrics-path Path under which to expose metrics /metrics

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

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.