Munin contributed plugins

#!/bin/sh

#

# Copyright (C) 2008 Chris Wilson

# Copyright (C) 2006 Holger Levsen

#

# This program is free software; you can redistribute it and/or

# modify it under the terms of the GNU General Public License

# as published by the Free Software Foundation; version 2 dated June,

# 1991.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

#

# Configuration variables

#   vservers - specify the vservers to include in the graph (default: all)

#   limits - if true, turn on limit graphing (default: false)

#

# NOTE: If no configuration variables are set, the defaults will be used

# Example /etc/munin/plugin-conf.d/munin-node 

#

# The first group monitors the vservers named "vserver1 vserver2

# vserver3 vserver4" and looks to see if the resource limit has been

# breached, if so it sends a message to nagios via send_nsca, and

# sends an email to notify that this has happened.

#

# The second monitors the vservers "vserver5 vserver6 vserver7" and 

# has no limit notifications turned on.

#

# The third monitors all vservers on the system, in one graph, and it has

# no limit notifications defined.

#

# You can use any combination of these to fit your needs.

#

#

# [vsrmem_group1]

# user root

# env.vservers vserver1 vserver2 vserver3 vserver4

# env.limits 1

# contacts nagios email

# contact.nagios.command /usr/bin/send_nsca -H your.nagios-host.here -c /etc/send_nsca.cfg

# contact.email.command mail -s "Munin-notification for ${var:group} :: ${var:host}" your@email.address.here

#

# [vsrmem_group2]

# user root

# env.vservers vserver5 vserver6 vserver7

# env.limits 0

#

# [vserver_rmemory]

# user root

#

# Graph Vserver RSS usage and limits

#

# Changelog

# version 0.1 - 2006 April xx - Holger Levsen

#  - initial author

# version 0.2 - 2006 April 24 - Micah Anderson <micah@riseup.net>

#  - Add dynamic arch page size determination

#  - Some cleanup and clarification

# version 0.3 - 2006 May 3 - Micah Anderson <micah@riseup.net>

#  - Add ability to group vservers via environment vars

#  - Fix missing close quotes and standardize indents

#  - Add limit notification

#  - Update documentation to include info on groups and limits

# version 0.4 - 2006 Jun 22 - Micah Anderson <micah@riseup.net>

#  - Fix error that results if NodeName is set to include a domain name

# version 0.5 - 2008 Apr 12 - Chris Wilson <chris+munin@qwirx.com>

#  - Changed to display limit hits instead of resource usage

#  - Adapt to latest vserver kernel (lack of some variables in /proc/virtual)

#    Note that your vserver names may change if the contents of 

#    /etc/vservers/* do not match the nodenames. Also you must specify

#    the vservers variable with context IDs (XIDs) rather than names.

scriptname=`basename $0`

resource=`echo $scriptname | sed -e 's/.*_//'`

vservers="$vservers"

if [ -z "$vservers" ]; then

	vservers=`ls -1 /proc/virtual | grep -v info | grep -v status`

fi

if [ "$1" = "config" ]; then

	echo "graph_title Vserver $resource limit hits"

	# echo 'graph_args --base 1024k -l 0'

	echo "graph_vlabel $resource limit hits"

	echo 'graph_category vserver'

	echo "graph_info Shows number of hits on $resource limits by each vserver.'"

	for vserver_xid in $vservers ; do

		longname=`/usr/sbin/vuname --xid $vserver_xid NODENAME | cut -f2`

		name=`echo $longname | cut -d. -f1`

		echo "$vserver_xid.label $name"

		echo "$vserver_xid.info $resource limit hits by $longname"

		echo "$vserver_xid.critical 1"

		echo "$vserver_xid.min 0"

		echo "$vserver_xid.type DERIVE"

	done

	exit 0

elif [ "$1" = "suggest" ]; then

	if [ -z "$vservers" ]; then

		echo "No vservers running, cannot suggest!" >&2

		exit 2

	fi

	vserver1=`echo $vservers | sed -e 's/ .*//'`

	tail -n +2 /proc/virtual/$vserver1/limit | sed -e 's/:.*//'

else

	for vserver_xid in $vservers; do

		cat /proc/virtual/$vserver_xid/limit \

		| awk -v xid="$vserver_xid" -v res="$resource:" \

			'{ if ( $1 == res )

			printf "%s.value %d\n", xid, $7 }'

	done

fi