A Prometheus exporter for Freebox stats

freebox_exporter

• -endpoint: Freebox API url (default http://mafreebox.freebox.fr)
• -listen: port for Prometheus metrics (default :10001)
• -debug: turn on debug mode
• -fiber: turn off DSL metric for fiber Freebox

Here's what you can get in Prometheus / Grafana with freebox_exporter:

If you want to compile the binary, you can refer to this document which explains how to do it, depending on your OS and architecture. Alternatively, you can use ./build.sh.

You can also find the compiled binaries for MacOS, Linux (x86_64, arm64 and arm) and Windows in the release tab.

./freebox_exporter

• Freebox API endpoint

./freebox_exporter -endpoint "http://mafreebox.freebox.fr"

• Port

./freebox_exporter -listen ":10001"

docker run -d --name freebox-exporter --restart on-failure  -p 10001:10001 \
  saphoooo/freebox-exporter

• Local token

Volume allows to save the access token outside of the container to reuse authentication upon an update of the container.

docker run -d --name freebox-exporter --restart on-failure  -p 10001:10001 \
  -e HOME=token -v /path/to/token:/token saphoooo/freebox-exporter

• Freebox API endpoint

docker run -d --name freebox-exporter --restart on-failure -p 10001:10001
  saphoooo/freebox-exporter -endpoint "http://mafreebox.freebox.fr"

• Port

docker run -d --name freebox-exporter --restart on-failure -p 8080:10001 \
  saphoooo/freebox-exporter

If you launch the application for the first time, you must allow it to access the freebox API.

• The application must be launched from the local network.
• You have to authorize the application from the freebox front panel.
• You have to modify the rights of the application to give it "Modification des réglages de la Freebox"

Source: https://dev.freebox.fr/sdk/os/