1
0
mirror of https://github.com/Tafkas/fritzbox-munin.git synced 2023-10-10 11:36:55 +00:00

fritzbox-munin

A collection of munin plugins to monitor your AVM FritzBox router, forked from https://github.com/Tafkas/fritzbox-munin .

With my personal extensions for smart home devices such as temperature, humidity, battery, power, states. Originally based on fritzbox_smart_home_temperature.py of fork https://github.com/erni4711/fritzbox-munin, but significantly extended and reworked for FritzOS 7.29 + 7.56.

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

  • opening an issue
  • submitting a pull request

Current tests are performed with

  • FRITZ!Box 7490, Fritz!OS 7.56, (formerly 7.29)

In the original repository ( https://github.com/Tafkas/fritzbox-munin ) 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 7530
  • FRITZ!Box 7530 AX
  • FRITZ!Box 7560
  • FRITZ!Box 7580
  • FRITZ!Box 7590

If you are still running an older Fritz!OS version 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 username & password) http://i.imgur.com/A9uGvWP.png

fritzbox_cpu_temperature

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

fritzbox_memory_usage

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

fritzbox_power_consumption

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

fritzbox_uptime

fritzbox_uptime shows you the uptime in days (requires username & 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 username & password) (language dependant, see below). http://i.imgur.com/lqvK1b2.png

fritzbox_smart_home

fritzbox_smart_home shows the temperatures, power, states etc. of connected smart home devices

Installation & Configuration

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

     pip install -r requirements.txt
    

fritzconnection requires python3. Make sure python --version is >= 3.6.

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

  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_username <fritzbox_username>
     env.fritzbox_password <fritzbox_password>
     env.traffic_remove_max true # if you do not want the possible max values
     host_name fritzbox
    
  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
    
  2. Add the following to your munin-node configuration

    env.host_name fritzbox

  3. 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.

Description
No description provided
Readme 223 KiB
Languages
Python 100%