Freebox-OS-munin icon indicating copy to clipboard operation
Freebox-OS-munin copied to clipboard

Low depencendies Freebox OS munin plugin

Freebox-OS-munin

Freebox Revolution & Freebox Mini 4K stats monitoring using munin

This script has been tested upon Python 2.7, 3.2 & 3.5. See below for some screenshots

Usage

  1. This plugin relies on requests: (replace pip with the version you use)

    pip install requests
    
  2. Clone this project on your server:

    git clone https://github.com/chteuchteu/Freebox-OS-munin.git
    cd Freebox-OS-munin
    
  3. Launch authorization script

    ./main.py authorize
    
  4. Update permissions on authorization file

    chmod 0660 freebox.json
    sudo chgrp munin freebox.json
    
  5. Install the plugins

    Tip: you don't have to symlink each mode. Skip some if you don't need all information

    ./create_symlinks.py
    sudo ln -sf $(pwd)/freebox-* /etc/munin/plugins
    
  6. Restart munin node service

    sudo service munin-node restart
    
  7. Test it

    sudo munin-run freebox-traffic
    

Contribute

Fork this repository, and submit pull requests upon master branch.

Tip: when making changes that affects all plugins, you can tests them all by running ./main.py --mode all. This will execute each plugin in both config & poll modes.

Graphs

  • freebox-traffic
    freebox-traffic
  • freebox-xdsl
    freebox-xdsl
  • freebox-xdsl-errors
    freebox-xdsl-errors
  • freebox-temp
    freebox-temp
  • freebox-fan-speed
    freebox-temp
  • freebox-switch-stations1 (1..4)
    freebox-switch-stations1
  • freebox-switch1 (1..4)
    freebox-switch1
  • freebox-switch-bytes1 (1..4)
    freebox-switch1
  • freebox-switch-packets1 (1..4)
    freebox-switch1
  • freebox-df
    freebox-df
  • freebox-hddspin
    freebox-hddspin
  • freebox-transmission-tasks
    freebox-hddspin
  • freebox-transmission-traffic
    freebox-hddspin
  • freebox-connection
    freebox-connection
  • freebox-connection-log
    freebox-connection-log
  • freebox-ftth
    freebox-ftth
  • freebox-wifi-bytes
    freebox-wifi-bytes
  • freebox-wifi-bytes-log
    freebox-wifi-bytes
  • freebox-wifi-stations
    freebox-wifi-bytes