fritzbox-munin/README.md

fritzbox-munin

A collection of munin plugins to monitor your AVM FRITZ!Box router. The scripts have been developed using a FRITZ!Box 7590(Amazon link) running FRITZ!OS 7.00.

If you are using the scripts on a different Fritz!Box model please let me know by

• opening an issue
• submitting a pull request

So far the following models (running FRITZ!OS 06.83) have been confirmed working:

• FRITZ!Box 3370
• FRITZ!Box 5490
• FRITZ!Box 7362 SL
• FRITZ!Box 7390
• FRITZ!Box 7430
• FRITZ!Box 7490
• FRITZ!Box 7560
• FRITZ!Box 7580
• FRITZ!Box 7590

If you are still running Fritz!OS 6.30 check out the releases section.

Introduction

These python scripts are Munin plugins for monitoring the Fritz!Box router by AVM.

fritzbox_traffic

fritzbox_traffic shows you the traffic of the WAN interface (requires fritzconnection)

If you do not want to show the interface maximum values, add the following to your plugin-configuration:

env.traffic_remove_max true

fritzbox_connection_uptime

fritzbox_connection_uptime shows you the connection uptime in days (requires fritzconnection)

fritzbox_cpu_usage

fritzbox_cpu_usage shows you the cpu usage (requires password)

fritzbox_cpu_temperature

fritzbox_cpu_temperature shows you the cpu temperature (requires password)

fritzbox_memory_usage

fritzbox_memory_usage shows you the memory usage (requires password)

fritzbox_power_consumption

fritzbox_power_consumption shows you the power consumption (requires password)

fritzbox_uptime

fritzbox_uptime shows you the uptime in days (requires password) (language dependant, see below).

fritzbox_wifi_devices

fritzbox_wifi_devices shows you the number of connected wifi clients (requires password) (language dependant, see below).

Installation & Configuration

1. Pre-requesites for the fritzbox_traffic and fritzbox_uptime plugins are the fritzconnection and requests package. To install it

    pip install fritzconnection
    pip install lxml
   

2. Make sure the FritzBox has UPnP status information enabled. (German interface: Heimnetz > Heimnetzübersicht > Netzwerkeinstellungen > Statusinformationen über UPnP übertragen)

3. Copy all the scripts (*.py) to /usr/share/munin/plugins

4. Make all the scripts execute able (chmod 755 /usr/share/munin/plugins.*py)

5. Create entry in /etc/munin/plugin-conf.d/munin-node:

a. only one fritzbox or all fritz boxes use the same password: [fritzbox_*] env.fritzbox_password <fritzbox_password> env.traffic_remove_max true # if you do not want the possible max values

b. multble fritz boxes: [fritzbox__*] env.fritzbox_password <fritzbox_password> env.traffic_remove_max true # if you do not want the possible max values

    [fritzbox_<fqdn2>_*]
    env.fritzbox_password <fritzbox_password>
    env.traffic_remove_max true # if you do not want the possible max values

6. Create symbolic link in /etc/munin/plugins for fritzbox_helper.py. cd /etc/munin/plugins ln -d /usr/share/munin/plugins/fritzbox_helper.py fritzbox_helper.py

7. Create symbolic link in /etc/munin/plugins for probes. link /usr/share/munin/plugins/fritzbox__<probe>.py to fritzbox_<fqdn>_<probe>

example cd /etc/munin/plugins ln -d /usr/share/munin/plugins/fritzbox__cpu_usage.py fritzbox_fritz.box_cpu_usage ln -d /usr/share/munin/plugins/fritzbox__cpu_temperature.py fritzbox_fritz.box_cpu_temperature
...

if you have multible fritz box just create multble sets of links with a different fqdn or ip.

example cd /etc/munin/plugins ln -d /usr/share/munin/plugins/fritzbox__cpu_usage.py fritzbox_fritz.box_cpu_usage ln -d /usr/share/munin/plugins/fritzbox__cpu_usage.py fritzbox_box2.fritz.box_cpu_usage ln -d /usr/share/munin/plugins/fritzbox__cpu_usage.py fritzbox_192.168.100.1_cpu_usage ln -d /usr/share/munin/plugins/fritzbox__cpu_temperature.py fritzbox_box2.fritz.box_cpu_temperature
ln -d /usr/share/munin/plugins/fritzbox__cpu_temperature.py fritzbox_box2.fritz.box_cpu_temperature
ln -d /usr/share/munin/plugins/fritzbox__cpu_temperature.py fritzbox_192.168.100.1_cpu_temperature
...

8. Restart the munin-node daemon: systemctl restart munin-node.

9. Done. You should now start to see the charts on the Munin pages.

Localization

Two scripts depend on the language selected in your fritzbox: the uptime and wifi_devices. Currently, two locales are supported:

1. German: de (default)
2. English: en

You can change the used locale by setting an environment variable in your plugin configuration:

env.locale en

Set a group for your fritz boxes

You can group the graphs of your fritzbox:

1. Use the following as your host configuration in /etc/munin/munin.conf or by creating a file in /etc/munin/munin-conf.d

    [<groupname>;<fqdn>]
        address 127.0.0.1
        use_node_name no
   

example: [Network;fritz.box] address 127.0.0.1 use_node_name no

2. Restart your munin-node: systemctl restart munin-node

Environment Settings

Do not forget to restart the munin-node daemon as described in step 3 of the installation instructions above.