mirror of
https://github.com/munin-monitoring/contrib.git
synced 2018-11-08 00:59:34 +01:00
|
||
---|---|---|
.. | ||
pypmmn | ||
README.rst | ||
setup.py |
PyPMMN ====== PyPMMN is a pure python port of pmmn_. It will also look for a *subdirectory* by a command-line parameter! Requirements ============ PyPMMN does not have any requirements other than the python standard library. For compatibility, it's targeted for Python 2.4 and up. Known Issues ============ * The stdin mode does not work correctly. Consider using the original pmmn_ instead. * It's not multithreaded. Only one connection is handled at a time. But given the nature of munin, this should not be an issue. Installation ============ The python way -------------- Download the folder and run:: python setup.py install This will install ``pypmmn.py`` into your system's ``bin`` folder. Commonly, this is ``/usr/local/bin``. And of course, you can use virtual environments too! Manually -------- Download the folder and copy both files ``pypmmn/pypmmn.py`` and ``pypmmn/daemon.py`` to a location of your choice and ensure ``pypmmn.py`` is executable. Usage ===== All command-line parameters are documented. Simply run:: pypmmn.py --help to get more information. Example:: pypmmn.py -l /path/to/log-dir -d /path/to/plugins -p 4949 Daemon mode ----------- In daemon mode, it's very helpful to specify a log folder. It gives you a means to inspect what's happening. In the case you specified a log folder, pypmmn will also create a file called ``pypmmn.pid`` containing the PID of the daemon for convenience. .. _pmmn: http://blog.pwkf.org/post/2008/11/04/A-Poor-Man-s-Munin-Node-to-Monitor-Hostile-UNIX-Servers