/fritzdocsis

DOCSIS monitoring on FritzBox 6490 Cable with Prometheus

Primary LanguageGoMIT LicenseMIT

FritzBox Docsis Monitoring

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.

Building and Running the Exporter

To run the exporter:

  1. Clone this repository and cd into it
  2. Run go mod tidy to get the dependencies
  3. Run go install fritzDocsis.go to build the binary for your platform
  4. Run ${GOPATH}/bin/fritzDocsis to 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.

Scraping the Exporter via Prometheus

How 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

Looking at the data from Grafana

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:

Grafana Dashboard