redturtle.munin 0.0.3

Munin plugins for zope/plone

Introduction

This package provides munin plugins with zope scripts which provides the data.

• it uses gocept.munin for plugin registration. Please check it if you want towrite new plugins.

• some plugins are based on plugins found at munin exchange (many thanks to Gaute Amundsen and Arthur Lutz)

Plugins

There are 3 plugins available (new comming soon):

• zope threads - checks free zope threads

• zope cache parameters - checks database cache parameters

• zodb activity - checks zodb activity

How to use it

• First include it in you buildout instance slot:

  [instancne]
  ...
  eggs =
  ...
  redturtle.munin
  
  zcml =
  ...
  redturtle.munin

• Now you should be able to call the plugins as follow:

  http://localhost:8080/@@redturtle.munin.plugins/update?munin_plugin=zopethreads

  Where zopethreads is you plugin name. Please notice that for the security reason plugins can be called only from localhost (this will be configure better in the future)

• Now you need to make a symlink from egg to munin plugin directory:

  $ cd /opt/munin/etc/plugins
  $ ln -s ~/.buildout/eggs/redturtle.munin-0.0.3-py2.4.egg/redturtle/munin/plugins/zodb_activity.py company_zodbactivity_site1

  Where /opt/munin/etc/plugins is your munin directory, ~/.buildout/eggs is you egg directory, zodb_activity.py the plugin you want to enable, company your prefix, and site1 the name which will be shown in munin

• Finally configure the plugin in munin:

  $ cd /opt/munin/etc/plugin-conf.d/
  $ vi redturtle.conf
  ... [company_*_site1]
  ... env.AUTH myuser:myuser
  ... env.URL http://localhost:8080/@@redturtle.munin.plugins/update?munin_plugin=%s

  Where myuser is your zope user credential, localhost:8080 your site url. Please check munin for more info about plugin configuration.

References

• redturtle.munin at pypi

• gocept.munin at pypi

• munin project

• munin exchange

Author & Contact

Author:

Andrew Mleczko <[e-mail]>

RedTurtle Technology

http://www.redturtle.net

Changelog

0.0.3 - 2009/03/30

• add documentation [amleczko]

• refactor plugin registration [amleczko]

0.0.2 - 2009/03/26

• Small refactoring [amleczko]

0.0.1 - 2009/03/24

• Initial release [amleczko]