PyMunin Multigraph Munin Plugin for monitoring Varnish Cache Web Application Accelerator.

The plugin must be run with a user with sufficient privileges to execute varnishstat utility.

Multigraph Plugin: Yes
Multi-instance Plugin: Yes


The plugin implements the following graphs:

  • varnish_requests

  • varnish_hits

  • varnish_client_conn

  • varnish_backend_conn

  • varnish_traffic

  • varnish_workers

  • varnish_work_queue

  • varnish_memory

  • varnish_expire_purge


Configuration variables are passed to the Munin Plugins using environment variables. The environment variables for plugins are usually set in the plugin configuration files in the folder: /etc/munin/plugin-conf.d

The configuration variables implemented by the plugin are listed in the following table:

Variable Description
instance Name of the Varnish Cache instance.
(Defaults to hostname.)
include_graphs Comma separated list of enabled graphs.
(All graphs enabled by default.)
exclude_graphs Comma separated list of disabled graphs.

Additionally the following configuration variables are implemented by the plugin for Multi Instance support:

Variable Description
instance_name Name of instance.
instance_label Graph title label for instance. (Default is the same as instance name.)
instance_label_format Controls how the instance label will be added to the graph title:
  • suffix (Default)
  • prefix
  • none


Varnish Cache Plugin ( varnishstats ) has been developed by Ali Onur Uyar ([aouyar @ GitHub] (https://github.com/aouyar)).


Varnish Cache Plugin ( varnishstats ) is copyrighted free software made available under the terms of the GPL License Version 3 or later.

See the file COPYING that acompanies the code for full licensing information.