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!

Munin plugins for Varnish.

Project Description


A buildout recipe that packages and configures the munin tool varnish_ to enable monitoring of Varnish.

Contains a modified version of varnish_ r4439 created by Kristian Lyngstol which works with Varnish 2.0 or newer.

How to use it

You can use it with a part like this:

parts =

recipe = munin-varnish
varnishstat = ${varnish-build:location}/bin/varnishstat

Where varnish-build would be a typical cmmi part that builds Varnish. And the varnishstat option is the full path to the varnishstat binary.

This part will create a script in the buildout bin directory called munin-varnish which is used to monitor all the different aspects. The current list of aspects available for monitoring is (bin/munin-varnish suggest):


Each of these need to be installed as symlinks into the munin-node plugins. For example:

cd /etc/munin/plugins
ln -s /path/to/buildout/bin/munin-varnish varnish_expunge

Monitoring multiple instances

You can use the optional parameter name to add a name to the graph titles:

recipe = munin-varnish
varnishstat = ${varnish-build:location}/bin/varnishstat
name = Project X

In the above Example calling graph_title Object expunging would become graph_title Object expunging - Project X.

To monitor multiple instances you need to be able to put different symlinks into your etc/munin/plugins/ directory. You can use double underscore in the symlink installation to separate the instance name from the aspect. The above installation example would become:

cd /etc/munin/plugins
ln -s /path/to/buildout/bin/munin-varnish varnish_projectX__expunge

(ATTENTION: note the double underscore!).

We are using a slightly modified version of varnish_ to support multiple instances. See this post on varnish-dev for more information.


  • A build of varnishstat requires the developer’s libraries for ncurses. If you don’t have a varnishstat in your build of Varnish then most likely you need to install the ncurses-devel or libncurses5-dev package and then get buildout to rebuild Varnish.
  • The hit_rate aspect only works correctly with a munin server running version 1.4.0 alpha or better. However hit rate data is also available in request_rate where it is presented as raw rates rather than normalized as a percentage.


Michael Dunstan, Author

Harald Friessnegger, added support for multiple instances


1.0a3 (2010-08-16)

  • update to newest revision (r4439) of varnish_ [fRiSi]
  • add support for monitoring multiple varnish instances on a single host [fRiSi]

1.0a2 (2009-11-26)

  • Ensure that the generated script is executable.

1.0a1 (2009-11-26)

  • Initial release.

Release History

This version
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
(11.6 kB) Copy SHA256 Hash SHA256
Egg 2.6 Aug 16, 2010
(17.6 kB) Copy SHA256 Hash SHA256
Source None Aug 16, 2010

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