h2. Varnish plugins for munin monitoring

h3. Plugins Version 1

These plugins are originally taken from "muninexchange":http://muninexchange.projects.linpro.no/?search=&cid=37&os[4]=on&os[7]=on&os[3]=on&os[2]=on&os[5]=on&os[8]=on&os[1]=on&os[6]=on to have a git repository to check out on every munin node

h4. Installation

on your munin node do:

cd /usr/share/munin/plugins (or your munin plugins directory)
sudo git clone git://github.com/basiszwo/munin-varnish.git
sudo chmod a+x /usr/share/munin/plugins/munin-varnish/varnish_*
sudo ln -s /usr/share/munin/plugins/munin-varnish/varnish_* /etc/munin/plugins/

change your munin node config and add the following to /etc/munin/plugin-conf.d/munin-node

[varnish*]
user root

restart your munin node:

sudo /etc/init.d/munin-node restart

h4. Munin graphs

!http://github.com/basiszwo/munin-varnish/raw/master/assets/munin-varnish-v1.png(Munin graphs for varnish v1)!

h3. Plugin Version 2

This munin plugin for Varnish 2.x "has been removed":http://www.varnish-cache.org/trac/changeset/5353 from the varnish repostory. You may find it in the "official munin repository":http://exchange.munin-monitoring.org/plugins/search?keyword=varnish

As it was a bit tricky to get this plugin running I want to share my experiences with it.

h4. Installation

on your munin node do:

cd /usr/share/munin/plugins (or your munin plugins directory)
sudo git clone git://github.com/basiszwo/munin-varnish.git
sudo chmod a+x /usr/share/munin/plugins/munin-varnish/varnish2_

Depending on what you want to monitor link the varnish2_ script to one of the following:

hit_rate, request_rate, objects, backend_traffic, transfer_rates, threads, memory_usage, uptime, vcl_and_purges, expunge, vcl_and_purges, lru, allocations, shm, shm_writes, session, session_herd, objoverflow, esi, hcb, obj_sendfile_vs_write, losthdr, objects_per_objhead

h4. Recommended

ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_hit_rate
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_request_rate
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_objects
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_backend_traffic
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_transfer_rates
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_threads
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_memory_usage
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_uptime
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_vcl_and_purges

h4. Interesting depending your setup

ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_expunge; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_vcl_and_purges; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_lru; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_allocations; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_shm; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_shm_writes; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_session; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_session_herd; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_objoverflow; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_esi; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_hcb; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_obj_sendfile_vs_write; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_losthdr; 
ln -s /usr/share/munin/plugins/varnish2_ /etc/munin/plugins/varnish2_objects_per_objhead;

h4. Configuration for munin node

Config file is /etc/munin/plugin-conf.d/munin-node

[varnish2_*]
  user root
  env.varnishstat varnishstat
  env.name

restart your munin node:

sudo /etc/init.d/munin-node restart

h4. Munin graphs

!http://github.com/basiszwo/munin-varnish/raw/master/assets/munin-varnish-v2.png(Munin graphs for varnish v2)!