Python Package for Munin Multigraph Plugins

Origin

Standalone Python 3 adaptation of the PyMunin package. This package does not include the plugins. If you are interested in the plugins, you can find the Python 3 adaptation on GitHub. A test release is available on TestPyPI.

About

Python module for developing Munin Multigraph Plugins.

More detailed documentation of the project and sample graphs for plugins are published on the PyMunin Project Web Page.

Regular Munin Plugins employ one plugin, one graph logic and require the execution of a script for data retrieval for each graph. Multigraph plugins permit retrieval of data for multiple graphs in one execution run (one plugin, many graphs), reducing the processing time and delay for the fetch cycle significantly. More information on Multigraph Plugins can be found in the Munin Guide:

• Multigraph Plugins
• Multigraph Protocol Extension

The pymunin module implements the base classes for developing Munin plugins. Although the solution is focused on implementing multigraph plugins the module also supports simple single graph plugins.

Licensing

PyMunin3 is free software made available under the terms of the GPL License Version 3.

See the LICENSE file that accompanies the code for full licensing information.

Download

New versions are released on PyPI (the Python Package Index) periodically.

You can get the latest development version of the code by cloning the Git repository for the project:

git clone git://github.com/penguinpee/PyMunin3

Installation

The easiest way to install the module is by using pip:

pip install PyMunin3

To build and install from source:

cd PyMunin3
python3 -m build
pip install dist/*.whl

Collaboration

Please report issues on GitHub. Pull requests are also welcome.

Credits

PyMunin has been developed by aouyar (Ali Onur Uyar).

Changes for Python 3 by penguinpee (Sandro).

Some of the people that have knowingly or unknowingly contributed to the development:

• Initial packaging of the code was done by Mark Lavin (mlavin). PyMunin is installable using pip / easy_install thanks to Mark. :-)
• PyMunin has been packaged for Fedora and Red Hat Enterprise Linux by Matthias Runge.
• The initial design of the solution was inspired by python-munin by Samuel Stauffer.
• The Rackspace Cloud plugin was initially developed by Ben Welsh.
• Sebastian Rojo has contributed many improvements to the Asterisk Plugin.
• Preston Mason has made significant contributions to the Varnish Cache and PHP APC Cache Plugins.
• Many plugins were inspired by existing _Munin Plugins_developed by other people. (Before developing any plugins, I always try to check existing solutions.)
• Many people have contributed by testing the plugins and identifying issues.

Final Words

Ali Onur Uyar

I hope that more people will be using PyMunin for developing plugins in the future.

I released PyMunin3 to give credit to the original PyMunin package. Adapting it to Python 3 allowed me to quickly develop a plugin in Python. Hopefully, others will discover the usefulness of this excellent module and more plugins using PyMunin will appear in the Munin Plugin Gallary.

My intention is to get these changes merged into the original PyMunin package, eventually. I contacted Ali about it, but he doesn't appear to have much time at the moment.