1
0
mirror of https://github.com/Tafkas/fritzbox-munin.git synced 2023-10-10 13:36:55 +02:00
fritzbox-munin/README.md
2017-09-06 21:35:23 +02:00

3.5 KiB

fritzbox-munin

A collection of munin plugins to monitor your AVM FRITZ!Box router. The scripts have been developed using a FRITZ!Box 7362 SL(Amazon link) running FRITZ!OS 06.83. This script also only works if the language of the Fritz!Box is set to German (this holds only for the uptime and wifi devices check).

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:

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)
http://i.imgur.com/8BwNMOL.png

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)
http://i.imgur.com/8oE1OYL.png

fritzbox_cpu_usage

fritzbox_cpu_usage shows you the cpu usage (requires password)
http://i.imgur.com/A9uGvWP.png

fritzbox_cpu_temperature

fritzbox_cpu_temperature shows you the cpu temperature (requires password)
http://i.imgur.com/duHYhw6.png

fritzbox_memory_usage

fritzbox_memory_usage shows you the memory usage (requires password)
http://i.imgur.com/WhxrINK.png

fritzbox_power_consumption

fritzbox_power_consumption shows you the power consumption (requires password)
http://i.imgur.com/a7uQzn6.png

fritzbox_uptime

fritzbox_uptime shows you the uptime in days (requires password)
http://i.imgur.com/Jr8OibH.png

fritzbox_wifi_devices

fritzbox_wifi_devices shows you the number of connected wifi clients (requires password) http://i.imgur.com/lqvK1b2.png

Installation & Configuration

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

     pip install fritzconnection
    
  2. Copy all the scripts to =/usr/share/munin/plugins

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

     [fritzbox_*]  
     env.fritzbox_ip <ip_address_to_your_fritzbox>  
     env.fritzbox_password <fritzbox_password>  
    
  4. Create symbolic links to /etc/munin/plugins.

  5. Restart the munin-node daemon: /etc/init.d/munin-node restart.

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

Environment Settings

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