quentin-st / Freebox-OS-munin

Low depencendies Freebox OS munin plugin
GNU General Public License v2.0
17 stars 10 forks source link

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