1
0
mirror of https://github.com/Tafkas/fritzbox-munin.git synced 2023-10-10 13:36:55 +02:00
Go to file
Christian Stade-Schuldt 4e5ede6d12 Merge pull request #16 from bobvandevijver/separate-hosts
Fixes #15. Add support for separate hosts
2017-09-06 22:34:31 +02:00
.gitignore update scripts for FRITZ!OS:131.06.36-32026 BETA 2015-12-19 11:34:21 +01:00
Changelog.md update readme 2017-06-11 22:23:29 +02:00
fritzbox_connection_uptime.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_cpu_temperature.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_cpu_usage.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_helper.py pep8 formatting 2015-06-05 01:07:22 +02:00
fritzbox_memory_usage.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_power_consumption.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_traffic.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_uptime.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
fritzbox_wifi_devices.py Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00
LICENSE Initial commit 2015-06-02 23:37:01 +02:00
README.md Fixes #15. Add support for separate hosts 2017-09-06 22:33:15 +02:00

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.

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) (language dependant, see below). http://i.imgur.com/Jr8OibH.png

fritzbox_wifi_devices

fritzbox_wifi_devices shows you the number of connected wifi clients (requires password) (language dependant, see below). 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.

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

Different hosts for the fritzbox and your system

You can split the graphs of your fritzbox from the localhost graphs by following the next steps:

  1. Use the following as your host configuration in /etc/munin/munin.conf

[home.yourhost.net;server] address 127.0.0.1 use_node_name yes

[home.yourhost.net;fritzbox] address 127.0.0.1 use_node_name no

  1. Add the following to your munin-node configuration

    env.host_name fritzbox

  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.