diff options
Diffstat (limited to 'files/munin/vserver_resources')
| -rwxr-xr-x | files/munin/vserver_resources | 317 |
1 files changed, 317 insertions, 0 deletions
diff --git a/files/munin/vserver_resources b/files/munin/vserver_resources new file mode 100755 index 0000000..495614f --- /dev/null +++ b/files/munin/vserver_resources @@ -0,0 +1,317 @@ +#!/bin/sh +# +# Copyright (C) 2006-2008 Holger Levsen and Micah Anderson +# +# 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. + +# Graph Vserver resource usage and limits +# +# Configuration variables +# vservers - specify the vservers to include in the graph (default: all) +# resource - specify the resource to be monitored (no default) +# 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 following monitors the RSS value for 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: +# +# [vserver_resources] +# user root +# env.vservers vserver1 vserver2 vserver3 vserver4 +# env.resource RSS +# 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 +# +# This second example monitors the VM value for all vservers on the system and +# has no limit notifications turned on: +# +# [vserver_resources] +# user root +# env.vservers vserver5 vserver6 vserver7 +# env.resource VM +# env.limits 0 +# +# This last example monitors all the resources for vserver5. Note that +# this will be a busy graph, and it would be really useless if you +# specified more than one vserver when the resource is set to ALL: +# +# [vserver_resources] +# user root +# env.vservers vserver5 +# env.resource ALL +# env.limits 0 + +# Possible values for env.resource are: +# +# ALL - all the below resources +# PROC - number of processes +# VM - sum of all virtual pages inside the guest +# VML - sum of all virtual pages locked into memory +# RSS - number of pages currently present in RAM +# ANON - number of anonymous memory pages +# FILES - number of open files +# OFD +# LOCKS +# SOCK +# MSGQ +# SHM - number of shared memory pages + +# Changelog +# version 0.1 - 2006 April xx +# Holger Levsen <debian@layer-acht.org> +# - 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 - 2006 Oct +# Micah Anderson <micah@riseup.net> +# - fixed changelog entries so more changes can happen per version +# - standardized changelog date and name format +# - added myself to copyright +# - standardized indentation +# - abstracted from just RSS to be usable for any resource specified +# Holger Levsen <debian@layer-acht.org> +# - Fix hypens in NodeNames, replace them with underscores +# - Fix the fix from version 0.4 +# - allow specifying the ressource by linking +# (ln -s vserver_resources vserver_VM) +# - provided info about all resources +# - code cleaned +# - errors if an invalid resource is specified +# - handle identical vserver-names by using the vserver-id internally +# version 0.6 - 2007 Oct +# Micah Anderson <micah@riseup.net> +# - removed BASENAME - plugin isn't a wildcard plugin any longer +# - added $NAMELOC - fixes plugin so it works with VCI_SPACES (> 2.6.19) as well as older version +# +# TODO: +# - make it so you can specify more than one resource to be graphed? +# or define combined ressource-display: VM+RSS+ANON+SHM and FILES+OFD+LOCK+SOCK +# (for one vserver only) +# - and/or make it so you can graph all resources for one vserver +# - set a default for the resource if it is unset? +# - use /proc less often (100 times more overhead than talking to the kernel directly) +# i.e. use something like pagesize=`perl -MPOSIX -e 'print POSIX::sysconf(_SC_PAGESIZE), "\n";'` +# - ALL resource is broken + +VSERVERS="$vservers" +LIMITS="$limits" +RESOURCE="$resource" + +INFO=(`sed 's/.*:\t//' /proc/virtual/info 2>/dev/null || echo '<none>'`) +KCIN="$[ 16#${INFO[2]} ]"; + +# If this is 1, then VCI_SPACES is present in the kernel (new in 2.6.19) +if [ $[ (KCIN >> 10) & 1 ] -eq 1 ] +then + NAMELOC="nsproxy" +else + NAMELOC="cvirt" +fi + +if [ -z "$VSERVERS" ] ; then + XIDS=`find /proc/virtual/* -type d -exec basename {} \;` +else + # it's really more performant to specify vservers by ids or not at all + XIDS="" + for i in $VSERVERS ; do + if [ -d /proc/virtual/$i ] ; then + XIDS="${XIDS}${i} " + else + for j in `find /proc/virtual/* -type d -exec basename {} \;` ; do + if [ "$i" = "`cat /proc/virtual/$j/$NAMELOC |grep NodeName |cut -f2`" ] ; then + XIDS="${XIDS}${j} " + fi + done + fi + done +fi + +if [ "$1" = "config" ]; then + case "$RESOURCE" in + PROC) + echo 'graph_title Processes used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Processes' + echo 'graph_info Shows the number of processes used by each vserver.' + ;; + VM) + echo 'graph_title Virtual memory used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel VM pages' + echo 'graph_info Shows virtual memory (human readable) used by each vserver.' + ;; + VML) + echo 'graph_title Locked memory used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel VML pages' + echo 'graph_info Shows locked memory (human readable) used by each vserver.' + ;; + RSS) + echo 'graph_title Resident set size used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel RSS pages' + echo 'graph_info Shows resident set size (human readable) used by each vserver.' + ;; + ANON) + echo 'graph_title Anonymous memory used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel ANON pages' + echo 'graph_info Shows anonymous memory (human readable) used by each vserver.' + ;; + FILES) + echo 'graph_title Files used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Files' + echo 'graph_info Shows files used by each vserver.' + ;; + OFD) + echo 'graph_title Open filedescriptors used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Open filedescriptors' + echo 'graph_info Shows open filedescriptors used by each vserver.' + ;; + LOCKS) + echo 'graph_title Locks used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Locks' + echo 'graph_info Shows locks used by each vserver.' + ;; + SOCK) + echo 'graph_title Sockets used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Sockets' + echo 'graph_info Shows sockets used by each vserver.' + ;; + MSGQ) + echo 'graph_title Message queues used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel Message queues' + echo 'graph_info Shows message queues used by each vserver.' + ;; + SHM) + echo 'graph_title Shared memory used by vserver' + echo 'graph_args --base 1024k -l 0' + echo 'graph_vlabel SHM pages' + echo 'graph_info Shows shared memory (human readable) used by each vserver.' + ;; + *) + echo "$RESOURCE not defined." + exit 1 + ;; + esac + echo 'graph_category vserver' + + + # do not assume we are on i386 where pagesize is 4096... + pagesize=`perl -MPOSIX -e 'print POSIX::sysconf(_SC_PAGESIZE), "\n";'` + + for xid in $XIDS ; do + + LABEL=`cat /proc/virtual/$xid/$NAMELOC |grep NodeName |cut -f2` + NAME=`echo $LABEL | cut -d. -f1 | tr '-' '_'` + + case "$RESOURCE" in + PROC) + echo "$NAME.label $LABEL: processes" + echo "$NAME.info Number of processes used by $LABEL." + ;; + VM) + echo "$NAME.label $LABEL: Virtual memory" + echo "$NAME.info Size of virtual memory used by $LABEL. (Number multipled by $pagesize to make it human readable)" + echo "$NAME.cdef $NAME,$pagesize,*" + ;; + VML) + echo "$NAME.label $LABEL: Locked memory" + echo "$NAME.info Size of locked memory used by $LABEL. (Number multipled by $pagesize to make it human readable)" + echo "$NAME.cdef $NAME,$pagesize,*" + ;; + RSS) + echo "$NAME.label $LABEL: Resident set size" + echo "$NAME.info Size of resident set size used by $LABEL. (Number multiplied by $pagesize to make it human readable)" + echo "$NAME.cdef $NAME,$pagesize,*" + ;; + ANON) + echo "$NAME.label $LABEL: Anonymous memory" + echo "$NAME.info Size of anonymous memory used by $LABEL. (Number multiplied by $pagesize to make it human readable)" + echo "$NAME.cdef $NAME,$pagesize,*" + ;; + FILES) + echo "$NAME.label $LABEL: Files" + echo "$NAME.info Number of files used by $LABEL." + ;; + OFD) + echo "$NAME.label $LABEL: Open filedescriptors" + echo "$NAME.info Number of open filedescriptors used by $LABEL." + ;; + LOCKS) + echo "$NAME.label $LABEL: Locks" + echo "$NAME.info Number of locks used by $LABEL." + ;; + SOCK) + echo "$NAME.label $LABEL: Sockets" + echo "$NAME.info Number of sockets used by $LABEL." + ;; + MSGQ) + echo "$NAME.label $LABEL: Message queues" + echo "$NAME.info Number of message queues used by $LABEL." + ;; + SHM) + echo "$NAME.label $LABEL: Shared memory" + echo "$NAME.info Size of shared memory used by $LABEL. (Number multiplied by $pagesize to make it human readable)" + echo "$NAME.cdef $1,$pagesize,*" + ;; + *) + echo "$RESOURCE not defined." + exit 1 + ;; + esac + + if [ ! -z "$LIMITS" -a "$LIMITS" = 1 ]; then + LIMIT=`cat /proc/virtual/$xid/limit | grep $RESOURCE | cut -f4` + if [ ${LIMIT:-0} -gt 0 ]; then + echo "$NAME.critical $LIMIT" + fi + fi + done + exit 0 +fi + + +for xid in $XIDS ; do + LABEL=`cat /proc/virtual/$xid/$NAMELOC |grep NodeName |cut -f2` + NAME=`echo $LABEL | cut -d. -f1 | tr '-' '_'` + cat /proc/virtual/$xid/limit | awk -v name="${NAME}" -v resource="${RESOURCE}:" \ + '{ if ( $1 == resource ) + printf "%s.value %d\n", name, $2 }' +done + |