- Repository
- Munin (master)
- Last change
- 2019-02-08
- Graph Categories
- Family
- auto
- Capabilities
- Keywords
- Language
- Bash
- License
- GPL-2.0-only
- Authors
vserver_resources
Name
vserver_resources - Plugin to graph Vserver resource usage and limits
Configuration
This plugin uses the following configuration variables
[vserver_resources]
env.vservers - specify the vservers to include in the graph
env.resource - specify the resource to be monitored
env.limits - if true, turn on limit graphing
Default Configuration
This is the default configuration
[vserver_resources]
env.vservers <all vservers>
env.limits false
Example Configurations
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
Usage
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
Author
Copyright (C) 2006-2008 Holger Levsen
Copyright (C) 2006-2008 Micah Anderson
License
GNU GPLv2
Todo
Less shell subprocesses
The plugin uses lots and lots of shell subprocesses. Maybe factor common vserver plugin code into Munin::Plugin::Linux::Vserver?
Multigraph
make it so you can specify more than one resource to be graphed? Alternatively define combined resource-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
Default resource
set a default for the resource if it is unset?
Use /proc less often
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”;'\`
Bugs
The “ALL” resource is broken
Magic Markers
#%# family=auto
#%# capabilities=autoconf
#!/bin/bash
: <<'=cut'
=head1 NAME
vserver_resources - Plugin to graph Vserver resource usage and limits
=head1 CONFIGURATION
This plugin uses the following configuration variables
[vserver_resources]
env.vservers - specify the vservers to include in the graph
env.resource - specify the resource to be monitored
env.limits - if true, turn on limit graphing
=head2 DEFAULT CONFIGURATION
This is the default configuration
[vserver_resources]
env.vservers <all vservers>
env.limits false
=head1 EXAMPLE CONFIGURATIONS
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
=head1 USAGE
Possible values for env.resource are:
=over 4
=item ALL
all the below resources
=item PROC
number of processes
=item VM
sum of all virtual pages inside the guest
=item VML
sum of all virtual pages locked into memory
=item RSS
number of pages currently present in RAM
=item ANON
number of anonymous memory pages
=item FILES
number of open files
=item OFD
=item LOCKS
=item SOCK
=item MSGQ
=item SHM
number of shared memory pages
=back
=head1 AUTHOR
Copyright (C) 2006-2008 Holger Levsen
Copyright (C) 2006-2008 Micah Anderson
=head1 LICENSE
GNU GPLv2
=begin comment
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.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
=end comment
=head1 TODO
=over 4
=item Less shell subprocesses
The plugin uses lots and lots of shell subprocesses. Maybe factor
common vserver plugin code into Munin::Plugin::Linux::Vserver?
=item Multigraph
make it so you can specify more than one resource to be graphed?
Alternatively define combined resource-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
=item Default resource
set a default for the resource if it is unset?
=item Use /proc less often
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";'\`
=back
=head1 BUGS
The "ALL" resource is broken
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
=cut
if [ "$1" = "autoconf" ]; then
if [ -r /proc/virtual/info ]; then
echo yes
else
echo "no (/proc/virtual/info not found)"
fi
exit 0
fi
VSERVERS="${vservers:-}"
LIMITS="${limits:-}"
RESOURCE="${resource:-}"
# shellcheck disable=SC2207
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
# shellcheck disable=SC2044
for j in $(find /proc/virtual/* -type d -exec basename {} \;) ; do
if [ "$i" = "$(grep "NodeName" "/proc/virtual/$j/$NAMELOC" | cut -f 2)" ]; 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 virtualization'
# 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=$(grep "NodeName" "/proc/virtual/$xid/$NAMELOC" | cut -f 2)
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 multiplied 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 multiplied 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 [ -n "$LIMITS" ] && [ "$LIMITS" = 1 ]; then
LIMIT=$(grep "$RESOURCE" "/proc/virtual/$xid/limit" | cut -f 4)
if [ "${LIMIT:-0}" -gt 0 ]; then
echo "$NAME.critical $LIMIT"
fi
fi
done
exit 0
fi
for xid in $XIDS ; do
LABEL=$(grep "NodeName" "/proc/virtual/$xid/$NAMELOC" | cut -f 2)
NAME=$(echo "$LABEL" | cut -d. -f1 | tr '-' '_')
awk -v name="${NAME}" -v resource="${RESOURCE}:" \
'{ if ( $1 == resource ) printf "%s.value %d\n", name, $2 }' \
"/proc/virtual/$xid/limit"
done