This project contains the fritzdocsis source code that can be used to monitor the coax downstream connection quality. This project is an Exporter for Prometheus. To use it, you will need a Prometheus server that scrapes this exporter and Grafana to display the result of the scrape.
To run the exporter:
- Clone this repository and cd into it
- Run
go mod tidyto get the dependencies - Run
go install fritzDocsis.goto build the binary for your platform - Run
${GOPATH}/bin/fritzDocsisto run the binary
To make live easier, this repository contains a systemd service that you can use to run and auto-start the exporter once you built and installed it.
For convienience this repo is also available as a container at quay.io/mulbc/fritzdocsis. Images are automatically build for amd64 and multiple arm architectures - so this should run on most hardwares including your Raspberry Pi.
To run this, try a command like this:
podman run --name fritzdocsis --publish 2112:2112 quay.io/mulbc/fritzdocsis -url http://192.168.178.1 -username admin -password secretHow to install and set up Promtheus is out of scope, but I recommend running Prometheus as a Docker container.
This exporter will be available on Port 2112.
An example scrape of the exporter with all the exported metrics is available here
I have created a very simple Grafana dashboard that will show the error rate and Mean Squared Error (MSE) as well as the channel power level over time. The dashboard is available here
Once deployed, the dashboard should look similar to this:
