Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

ZNagios provides the ability for Nagios and munin to tap into the Zope2 server and retrieve status and performance data.

Project Description


Nagios data

  • uptime
  • main database size
  • total reference count
  • errors in the root error log

Munin data

graphs provided by

nr of zeo clients connected to zeo server
XXX help document
nr of object loads and stores of the database

graphs provided by

uptime of the zope instance in days (1 hour is 0.041)
XXX help document
total number of errors, conflicts and unresolved conflicts
total number of object loads, stores and total number of database connections
number of active and total objects for each connection
number of active objects of all connections (see cacheconnections above)
size of the database in megabyte

Configure Nagios

Put a line like this in your nagios plugin configuration to make the plugin available:

command[check_zope]=/path/to/ -H $ARG1$ -p $ARG2$ -d $ARG3$
-r $ARG4$ -a $ARG5$

Put a line like this in your nagios host configuration to use the:


Configure Nagios

To get the correct command configuration for “check_zope”, copy the zope.cfg into your plugin config directory (debian: /usr/share/nagios/pluginconfig) or the commands.cfg in /etc/nagios/.

Then you can make use of the check_zope command for services:

define service{
            use                     generic-service
            host_name               thezopehost
            service_description     Zope
            check_command           check_zope!thezopehost!8080!1000000000!500000!admin:password

Configure Munin

Configure Plugins

Add a configuration file to vim /etc/munin/plugin-conf.d/zope to tell the plugins how to connect to zeo server/clients:

user root
env.MUNIN_ZOPE_HOST_instance1 http://localhost:8401/Control_Panel/munin
env.MUNIN_ZOPE_AUTHENTICATE_instance1 admin:admin
env.MUNIN_ZOPE_HOST_instance2 http://localhost:8402/Control_Panel/munin
env.MUNIN_ZOPE_AUTHENTICATE_instance2 admin:admin

user root
env.MUNIN_ZEO_HOST_ZEO1 localhost


Originally written by Christian Theune <ct at gocept dot com>.

Thanks for contributing ideas and code to:

  • Robrecht van Valkenburg (Pareto)
  • Martijn Pieters (Pareto)
  • Florian Schulze (independent)
  • Hanno Schlichting (Jarn)
  • Harald Friessnegger (Webmeisterei)
  • David Glick (Groundwire)


0.7.3 (2017-03-22)

  • Always close connection when there is an exception/error in a probe. [bsuttor]
  • Python2.7 compatibility for [fRiSi]

0.7.2 (2016-09-26)

  • Use same way to get stats database than stats connection probes. [bsuttor]

0.7.1 (2015-08-11)

  • Do not get threads in stats probe. [bsuttor]
  • Fix beautify_return_values for date. [bsuttor]

0.7 (2015-07-17)

  • Add [bsuttor]
  • Fix stats probe for probe which are collection and other args [bsuttor]
  • Add stats probe [jfroche]

0.6 (2012-12-19)

  • Enable registration of znagios probes as zc.monitor utilities (using five.z2monitor)

0.5 - 2011-03-14

  • can handle multiple databases now. [davisagli]

0.4.2 - 2010-10-21

0.4.1 - 2010-06-14

  • fixed Control_Panel/munin for Zope >= 2.11 (conflict_error are not global anymore) [fRiSi]

0.4 - 2009-11-19

  • uptime is given in days now, instead of seconds which is much more readable. fetch still returns seconds for backward compatibility, but config tells to compute the value (uptime.cdef uptime,86400,/) [fRiSi]
  • can handle multiple Databases now [fRiSi]
  • Documented munin data and configuration in README [fRiSi]
  • Corrected labels in Per connection caches graph [fRiSi]
  • Added dbsize graph to [fRiSi]

0.3 - 2009-02-25

  • Changed an import of Zope.App to Zope2.App for compatibility with recent Zope versions. [hannosch]
  • Added package infrastructure. [hannosch]
  • Moved the source code from to the repository at revision 29315. [hannosch]

0.2 - 2008-05-26

  • Remove hard-coded authorization string. [ctheune]
  • A script for reading data from a ZEO monitor server. [ctheune]
  • Added basic munin support. [ctheune]
  • Original implementation.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(12.5 kB) Copy SHA256 Hash SHA256
Source None Mar 22, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting