Archived community.zenoss.org | full text search
Skip navigation
Currently Being Moderated

ZenPacks.community.Varnish3

VERSION 3  Click to view document history
Created on: Dec 15, 2011 1:30 PM by dpetzel - Last Modified:  Mar 3, 2012 6:54 PM by dpetzel

ZenPacks.community.Varnish3

 

Contents

 

Description

A ZenPack to provide support for Varnish version 3.x metrics. It introduces a new command parser that is intended to be run over SSH. Metrics are parsed from the output of the varnishstat command on the Varnish 3.x server

 

Components

The ZenPack has the following:

  • A new command parser
    • ZenPacks.community.Varnish3.parsers.VarnishStat
  • A new monitoring template
    • Varnish3 in /Server/Linux

 

Requirements & Dependencies

  • Tested on Zenoss Version(s): 3.2.1
  • External Dependencies: SSH Access to Varnish Server
  • ZenPack Dependencies: None

 

Download

Download the appropriate package for your Zenoss version from the list below.

 

Installation

 

Normal Installation (packaged egg)

Copy the downloaded .egg to your Zenoss server and run the following commands as the zenoss user:

zenpack --install <package.egg>
zenoss restart

 

Developer Installation (link mode)

If you wish to further develop and possibly contribute back to the Varnish3 ZenPack you should clone the git repository, then install the ZenPack in developer mode using the following commands:

git clone git://github.com/ZCA/ZenPacks.community.Varnish3.git
zenpack --link --install ZenPacks.community.Varnish3
zenoss restart

 

Configuration

  • Ensure SSH access from your Zenoss server to your Varnish server is setup and working properly.
  • Ensure the SSH user you are using has access to run the varnishstatcommand
  • The provided monitoring template is not automatically bound to any specific device class. You will need to either create a new device class and bind the template to this device class, or bind the template directly to your Varnish 3.x servers in an existing device class.

 

Customizing or Changing The Monitoring Template

Varnish 3.x outputs a large quantity of statistics. Different stats are going to be valuable to different people. The provided template is simply a starting point. I tried to pick stats I thought would have common interest.

The command parser will support any of the stats that varnishstat will output however you'll need to create a new datapoint that matches the name of the stat you are interested in if its not already configured. Running varnishstat -xon your Varnish 3.x server will produce XML output containing all the stats. The <name>...</name> attribute of a stat would be the value to use when creating the new datapoint.

When adding datapoints, be sure to add them to the existing datasource. There is no need to create a second datasource. Keeping a single datasource will keep the number of SSH calls needed to a minimum.

 

Handling Statistics With The Same Name

When dumping the varnishstat output via XML, some stats will actually have the same value in their <name> node. Since each datapoint needs to have a unique name the command parser will do some alerations to ensure uniqueness. The parser will prepend the value of the <ident> node followed by a "-". Lets look at a real world example:

<stat>
   <type>SMA</type>
   <ident>s0</ident>
   <name>g_bytes</name>
   <value>1973411487</value>
   <flag>i</flag>
   <description>Bytes outstanding</description>
</stat>
<stat>
   <type>SMA</type>
   <ident>Transient</ident>
   <name>g_bytes</name>
   <value>297633</value>
   <flag>i</flag>
   <description>Bytes outstanding</description>
</stat>

In this example the command parser will produce the name "s0-g_bytes" for the first stat and "Transient-g_bytes" for the second one. Its important to understand this if you intend to add any additional datapoints to the template.

 

Change History

 

Screenshots

Varnish3_Cache_Hit_RateVarnish3_CacheHits_vs_MissesVarnish3_Client_ConnectionsVarnish3_Client_RequestsVarnish3_Expired_ObjectsVarnish3_Backend_Too_Late

Comments (0)