Skip to content
Low depencendies Freebox OS munin plugin
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
.gitignore
LICENSE.md
README.md
create_symlinks.py
db.py
fields.py
freebox.py
main.py
modes.py
util.py

README.md

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
You can’t perform that action at this time.