Fritzbox Monitoring mit Grafana Dashboard

Die Tage wurde ein interessantes Grafana Dashboard für einen Eigenbau Router (opnsense) vorgestellt. Da kam die Idee auf so ein Dashboard für die Fritzbox aufzubauen. Dazu findet man einiges im Netz. Eine Lösung war die Umsetzung mit einer InfluxDB die von einem Exporter Dienst befüllt wird. Das war schon ganz gut aber die Umsetzung ein wahres Grauen. Zumal die Docker Container eine InfluxDB2 statt eine InfluxDB installierten. Die InfluxDB musste mit UDP beliefert werden. Es begann eine Odysee der Fehlersuche. Konnte nun eine andere Lösung ausfindig machen. Die war schon sehr umfangreich und sehr informativer als die erste Lösung. So ist es nun mal in der Welt der Technik, man baut was auf und sieht dann eine andere und bessere Umsetzung.

Nun was brauchen wir:

• Eine Fritzbox https://amzn.to/3f2gWCo (*)
• Einen Docker Host mit Ubuntu 20.04 und Go Version 1.13.8 ( Optional wenn nicht Docker )
• Grafana Dashboard https://grafana.com/grafana/dashboards/12579
• Fritzbox Exporter https://github.com/sberk42/fritzbox_exporter/blob/master/docker-compose.yml
• Alle Files gibt es hier zum Download https://git.unixweb.net/jhummel/fritzbox-grafana-monitor

Starte die Installation :

Achtung: Funktioniert nur auf Rechner mit AMD64 Kernel Unterstützung ( kein ARM / Raspberry ) und nur mit Go Version 1.13.8 die auf Ubuntu Server 20.04 enthalten ist.

Update 10.06.2022 :

Es kann alternativ auch ein Docker Container aufgebaut werden , hat den Vorteil dass dieser ohne Fehler beim Komplilieren durchlaufen sollte.

...

git clone https://github.com/sberk42/fritzbox_exporter/ 
cd fritz_exporter 
docker-compose up -d 

Hier kann es etwas dauern da der Container direkt auf dem System gebaut wird.

Hinweis: Die weiteren Schritte können übersprungen werden, wenn Fritzbox-Exporter Docker verwendet wird und mit der “Einrichtung Fritzbox” weiter gemacht werden.

sudo apt install golang-1.13-go
go get github.com/sberk42/fritzbox_exporter/ 
cd $GOPATH/src/github.com/sberk42/fritzbox_exporter 
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o fritzbox_exporter main.go

Es sollte nun im aktuellen Verzeichnis eine Datei “fritzbox_exporter” vorhanden sein.

Erstelle ein Verzeichnis um die Dateien für den Exporter zu kopieren und kopiere alle JSON-Dateien dort hinein.

mkdir -p /usr/local/share/exporter
cp fritzbox_exporter /usr/local/share/exporter
cp *.json /usr/local/share/exporter

Erstelle ein System File unter /etc/systemd/system/fritzbox_exporter.service

[Unit]
Description=Prometheus fritzbox exporter
After=network.target
Wants=network.target

[Service]
User=prometheus
Group=prometheus
WorkingDirectory=/usr/local/share/exporter
ExecStart=/usr/local/share/exporter/fritzbox_exporter -username collectd -password <DeinPasswort> -listen-address 192.168.1.100:9042 -metrics-file /usr/local/share/exporter/exporter/metrics.json
Type=simple
Restart=always

[Install]
WantedBy=multi-user.target

Einrichtung Fritzbox:

Fritzbox einrichten mit Benutzer, Dienst und Passwort setzen

Jetzt prüfen ob die Fritzbox Daten wie gewünscht ausgibt. In der ersten Zeile wird der Exporter im Hintergrund gestartet. In der zweiten Zeile wird die Abfrage gestartet. Sollten hier Daten zu sehen sein, ist alles richtig eingerichtet. Im Anschluß Dienst Fritzbox Exporter starten. Die Listen Address muss entsprechend deinem Netzwerk und Server angepasst werden und dient nur als Platzhalter.

/usr/local/share/exporter/fritzbox_exporter -username collectd -password <DeinPasswort> -listen-address 192.168.1.100:9042 -metrics-file /usr/local/share/expoter/exporter/metrics.json& 

curl -s http://192.168.1.100:9042/metrics # Prüfung ob Daten vorhanden sind

sudo systemctl enable fritzbox_exporter # Dienst bei Reboot starten
sudo systemctl start fritzbox_exporter # Dienst starten
sudo systemctl status fritzbox_exporter # Prüfen ob Dienst gestartet ist

Docker Installation:

Starte nun die Docker Einrichtung. Hier setze ich voraus dass der Docker Host schon eingerichtet ist. Erstelle ein Verzeichnis $HOME/exporter und erstelle in dem Unterverzeichnis eine Datei “docker-compose.yml”. Starte den Container mit “docker-compose up -d” und überprüfe mit “docker ps” ob Container richtig gestartet wurde.

---
version: '3'

services:
  mon_prometheus:
    image: prom/prometheus:latest
    container_name: mon_prometheus
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - $PWD/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml
    depends_on:
      - mon_node-exporter
      - mon_cadvisor

  mon_node-exporter:
    image: prom/node-exporter:latest
    container_name: mon_node-exporter
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    command:
      - '--path.procfs=/host/proc'
      - '--path.sysfs=/host/sys'
      - '--path.rootfs=/rootfs'
      - '--collector.filesystem.ignored-mount-points="^(/rootfs|/host|)/(sys|proc|dev|host|etc)($$|/)"'
      - '--collector.filesystem.ignored-fs-types="^(sys|proc|auto|cgroup|devpts|ns|au|fuse\.lxc|mqueue)(fs|)$$"'

  mon_grafana:
    image: grafana/grafana:latest
    container_name: mon_grafana
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
      - /var/docker/data/monitoring/grafana:/var/lib/grafana
    ports:
      - 3000:3000
    user: "1000"  #  USER ID des Docker Users anpassen
    depends_on:
      - mon_prometheus
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.grafana.entrypoints=websecure"
      - "traefik.http.routers.grafana.rule=Host(`grafana.example.com`)"  # Domain anpassen
      - "traefik.http.routers.grafana.tls=true"
      - "traefik.http.routers.grafana.tls.certresolver=default"
      - "traefik.http.routers.grafana.middlewares=secHeaders@file"
      - "traefik.http.services.grafana.loadbalancer.server.port=3000"
    networks:
      - traefik_proxy
      - default

networks:
  traefik_proxy:
    external:
      name: traefik_proxy
  default:
    driver: bridge

 

Einrichtung Prometheus

Im Verzeichnis $HOME/exporter gibt es ein Unterverzeichnis prometheus mit der Datei prometheus.yml . Diese Datei wie folgt ändern und mit “docker-compose restart” neue Konfiguration einlesen.

---
global:
  scrape_interval: 60s
  evaluation_interval: 60s
  external_labels:
    monitor: 'homelab'
rule_files:
scrape_configs:
  - job_name: 'node-exporter'
    static_configs:
      - targets: ['mon_node-exporter:9100']

  - job_name: 'fritzbox_exporter'
    static_configs:
      - targets: ['192.168.1.100:9042']

Einrichtung Grafana

Starte Grafana Interface im Browser – http://<Docker-IP>:3000 und es sollte sich ein Anmeldefenster öffnen. Dort Anmeldung Benutzer und Passwort  =  admin:admin . Nach erfolgreicher Anmeldung wird man aufgefordert dem Benutzer “admin” ein neues Passwort zu vergeben. Im Anschluß eine neue Data Source Prometheus anlegen. Die URL lautet “http://mon_prometheus:9090” dann auf Testen und Speichern klicken.
Nun ein neues Dashboard erstellen mit “Import” und ID “12579” eintragen und auf Load klicken. 

Wenn alles richtig eingerichtet wurde sollte das Dashboard bereits mit Daten zu sehen sein.

Noch ein Hinweis:

Nimm bitte nur den fritzbox_exporter wie er oben angegeben ist, denn ein anderer Exporter liefert keine Daten bei Network Devices, das Panel ist einfach leer. Sollten hier Daten fehlen dann bitte nochmal von oben beginnen.

Architektur:

Anbei noch ein Bild von dem ganzen Aufbau im Überblick

Alle Artikel auf dieser Seite sind mit einem sogenannte Provision-Links. Wenn du auf so einen Verweislink klickst und über diesen Link einkaufst, bekomme ich von deinem Einkauf eine Provision. Weiterführende Infos gibt es hier unter Punkt 8 in der Datenschutzerklärung  https://blog.unixweb.de/datenschutzerklaerung/

Bei Fragen bitte die Kommentarfunktion nutzen.

Viel Spaß beim Aufbau und Monitoring der Fritzbox wünscht Joachim.