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