Skip to main content

Monitoring meta package for Zope/Plone installs

Project description


See the doc of

Use zc.monitor and additional plugins to fetch probes via another thread than the one defined in Zope.

Once the instance is running zc.monitor thread listen to another port ( in this buildout). You can query values using simple python script or nc.


echo 'uptime' | nc -i 1 localhost 8888

Or (when instance is up):

bin/instance monitor stats


telnet 8888



Currently supported probes:

  • cache_size – cache sizes informations

  • check_smtp – Check if SMTP is initialize, return number of errors found.

  • check_upgrade_steps – Check if all upgrade steps are ran.

  • conflictcount – number of all conflict errors since startup

  • count_users – the total amount of users in your plone site

  • count_valid_users – Count all users connected since 90 days

  • cpu_times – ?

  • creation_date_plonesite – Get creation date of plonesite object. Default return unix_time (defaut=True) if you want ISO time call ‘False’ attr.

  • dates – Return all date probes

  • dbactivity – number of load, store and connections on database (default=main) for the last x minutes (default=5)

  • dbinfo – Get database statistics

  • dbsize – size of the database (default=main) in bytes

  • errorcount – number of error present in error_log (default in the root).

  • health_ok – fast health check for load balancers that simply returns ‘OK’ (see doc/haproxy for usage)

  • health_db_connected – returns the string ‘OK’ if database (default=main) is connected. (see doc/haproxy for usage)

  • help – Get help about server commands

  • interactive – Turn on monitor’s interactive mode

  • last_login_time – Get last login time user. Default return unix_time (defaut=True) if you want ISO time call ‘False’ attr.

  • last_modified_plone_object_time – Get last modified plone object time. Default return unix_time (defaut=True) if you want ISO time call ‘False’ attr.

  • last_modified_zope_object_time – Get last modified zope object time. Default return unix_time (defaut=True) if you want ISO time call ‘False’ attr.

  • logstats – ?

  • memory_percent – ?

  • monitor – Get general process info

  • objectcount – number of object in the database (default=main)

  • quit – Quit the monitor

  • refcount – the total amount of object reference counts

  • requestqueue_size – number of requests waiting in the queue to be handled by zope threads

  • stats – Stats of all information Products.ZNagios know

  • threads – Dump current threads execution stack

  • unresolved_conflictcount – number of all unresolved conflict errors since startup

  • uptime – uptime of the zope instance in seconds

  • zeocache – Get ZEO client cache statistics

  • zeostatus – Get ZEO client status information

How it works

This package use differents package

  • five.z2monitor

  • Products.ZNagios

  • munin.zope

  • zc.z3monitor

  • zc.monitorcache

  • zc.monitorlogstats

Add lines on your buildout:

zope-conf-additional =
  <product-config five.z2monitor>


Note: place names and roles of the people who contribute to this package

in this file, one to a line, like so:

  • Benoît Suttor <>, Original Author

  • Harald Friessnegger (Webmeisterei GmbH)

Changelog (2018-02-01)

  • Close database connection after health check and improve haproxy documentation [fRiSi]

0.2.6 (2018-01-30)

  • Add probes for load balancer health-checks (see doc/haproxy.rst for an example) [fRiSi]

0.2.5 (2016-02-25)

  • Remove old threadframe dependency package. [bsuttor]

0.2.4 (2015-09-03)

  • Add eggs probe. [bsuttor]

0.2.3 (2015-08-25)

  • Return unix_time by default, you can still get ISO time with call parameters False. [bsuttor]

0.2.2 (2015-08-18)

  • Fix error if last_login is empty. [bsuttor]

0.2.1 (2015-08-13)

  • Return date in ISO format [bsuttor]

0.2.0 (2015-08-11)

  • Add a probe (dates) which return all probes date. [bsuttor]

  • Add last_login_time porbe. [bsuttor]

  • Add last_modified_plone_object_time probe. [bsuttor]

  • Add last_modified_zope_object_time probe. [bsuttor]

0.1.2 (2015-07-24)

  • Date probe are not more in stats probe (from Products.ZNagios). [bsuttor]

  • Add creation_date_plonesite probe [bsuttor]

0.1.1 (2015-07-22)

  • Return number of smtp errors found. [bsuttor]

0.1 (2015-07-17)

  • Add count_users probe [bsuttor]

  • Initial package [bsuttor]

Project details

Download files

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

Source Distribution

collective.monitor- (18.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page