~~~~~~~~~~~~
Requirements
~~~~~~~~~~~~

- Python >= 2.7
- psutil for Python
- Monit
- Munin-node
- Nginx

~~~~~~~~~~~
Install Egg
~~~~~~~~~~~

As usual, egg is installable using setuptools or pip, choice what you like. 
It is better and strongly suggested to use a virtualenv.
    
~~~~~~~
Install 
~~~~~~~

The fast way to install, is using generate.py. To use, simply call generate script
in bin directory.

# <virtualenv_path>/bin/generate

It will test the environment and configure cache folders. For every sensor, it will
ask a confirm. Every sensor creates in /etc/munin/plugin-conf.d a single configuration.
If you want to check/change, that is the place.  
        
Restart munin-node, munin-async (if you use that) and enjoy.

More details at

http://cippino.wordpress.com/tag/munin/
https://github.com/cippino/munin_plugins
https://pypi.python.org/pypi/munin_plugins

~~~~~~~~~
Configure
~~~~~~~~~

Usually a manual configuration is not required, but in some case you have to modify 
some path or else. All munin plugins ask by they self during installation what 
they need, and they write in /etc/munin/plugin-conf.d. Keep attention if you reinstall
using generate script because all setup will be overwriten.

For apache and nginx, you have to configure log file format using combined2:

Apache: LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" [[%D]]" combined2

Nginx: log_format combined2 '$remote_addr - $remote_user [$time_local]  '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent" [[$request_time]]';

After combined2 definition, you have to change your virtualhost configuration using 
this format instead of usual "combined".

~~~~~~~~~
Changelog
~~~~~~~~~

4.2
- Refactor setup and sensor using classes

4.1.3
- Fixed VAR folder creation

4.1.2
- Fixed Egg Configure Folders

4.1.1 
- Fixed Documentation

4.1 
- Refactor of env.py and configuration
- Refactor of plone_usage from monolithic implementation to modular
- Reduced number of Cache classes

4.0
- First Egg release

~~~~~~~~~~~~~~
Known Problems
~~~~~~~~~~~~~~

1 - Keep attection if you use SELinux or other kind of Security access framework,
because you have to configure all rights correctly. Usually, my choice is to
put down, because the call of monit get error about access denied.



