| Latest revision |
Your text |
| Line 1: |
Line 1: |
| − | [[Category: Monitoring]]
| + | == munin plugin == |
| | | | |
| − | [http://exchange.munin-monitoring.org/plugins/openvzcpu/details There is a plugin available on the Munin Exchange web site] which tracks CPU usage accross different containers.
| + | The plugin listed below grabs all the bean counters' values. |
| | | | |
| − | [http://exchange.munin-monitoring.org/plugins/openvz_/details A second is also available via the Munin plugin exchange] which tracks beancounter values.
| |
| | | | |
| − | Additionally, there are several plugins available on this page to monitor beancounter values in [http://munin.projects.linpro.no/ Munin].
| |
| − | The third one tries to combine the other two. (FIXME, maybe these should live in the Munin Exchange too?)
| |
| | | | |
| − | = "Simple" munin plugin =
| + | Please note, you have to configure plugin to run as root: |
| | | | |
| − | The plugin listed below grabs all the beancounters' values.
| + | <code> |
| | + | [vebc*] |
| | + | user root |
| | + | </code> |
| | | | |
| − | <source lang="bash">
| + | at /etc/munin/plugin-conf.d/ somewhere. |
| − | #!/bin/sh
| |
| − | #
| |
| − | # plugin to monitor OpenVZ bean counters.
| |
| − | #
| |
| − | #
| |
| − | #%# family=auto
| |
| − | #%# capabilities=autoconf suggest
| |
| − | | |
| − | ATTR=`basename $0 | sed 's/^vebc_//g'`
| |
| − | | |
| − | if [ "$1" = "autoconf" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | echo yes
| |
| − | exit 0
| |
| − | else
| |
| − | echo "no (/proc/bc/0/resources not found)"
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − | | |
| − | if [ "$1" = "suggest" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | cat /proc/bc/0/resources |
| |
| − | while read str; do
| |
| − | vals=($str)
| |
| − | echo ${vals[0]}
| |
| − | done
| |
| − | exit 0
| |
| − | else
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − | | |
| − | if [ "$1" = "config" ]; then
| |
| − | # echo "graph_order down up"
| |
| − | echo "graph_title $ATTR beancounter for containers"
| |
| − | echo 'graph_category system'
| |
| − | echo "graph_info 'Containers beancounters info'"
| |
| − | | |
| − | for CTID in `ls -d1 /proc/bc/???`; do
| |
| − | id=`basename $CTID`
| |
| − | grep $ATTR $CTID/resources |
| |
| − | while read str; do
| |
| − | | |
| − | vals=($str)
| |
| − | name=${vals[0]}
| |
| − | echo ${id}.label $id
| |
| − | echo "${id}.warning ${vals[3]}"
| |
| − | echo "${id}.critical ${vals[4]}"
| |
| − | done
| |
| − | done
| |
| − | | |
| − | exit 0
| |
| − | fi;
| |
| − | | |
| − | for CTID in `ls -d1 /proc/bc/???`; do
| |
| − | id=`basename $CTID`
| |
| − | grep $ATTR $CTID/resources |
| |
| − | while read str; do
| |
| − | vals=($str)
| |
| − | name=${vals[0]}
| |
| − | echo "$id.value ${vals[1]}"
| |
| − | done
| |
| − | done
| |
| − | </source>
| |
| − | | |
| − | = Extended Version for old system using user_beancounter =
| |
| − | | |
| − | Put it with the munin plugins and make a link for every
| |
| − | graph which should be produced named like:
| |
| − | | |
| − | vebc_VALUENAME1_VALUENAME2_..._CTID
| |
| − | | |
| − | e.g.: vebc_numflock_numpty_numsiginfo_101
| |
| − | | |
| − | <source lang="bash">
| |
| − | #!/bin/sh
| |
| − | #
| |
| − | # plugin to monitor OpenVZ bean counters.
| |
| − | #
| |
| − | #
| |
| − | #%# family=auto
| |
| − | #%# capabilities=autoconf suggest
| |
| − | | |
| − | ATTR=`basename $0 | sed -e 's/^vebc_.*_//'`
| |
| − | STATS=`basename $0 | sed -e 's/^vebc_//' -e 's/_[0-9]*$//' -e 's/_/ /g'`
| |
| − | | |
| − | if [ "$1" = "autoconf" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | echo yes
| |
| − | exit 0
| |
| − | else
| |
| − | echo "no (/proc/bc/0/resources not found)"
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − | | |
| − | if [ "$1" = "suggest" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | cat /proc/bc/0/resources |
| |
| − | while read str; do
| |
| − | vals=($str)
| |
| − | echo ${vals[0]}
| |
| − | done
| |
| − | exit 0
| |
| − | else
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − | | |
| − | if [ "$1" = "config" ]; then
| |
| − | # echo "graph_order down up"
| |
| − | echo "graph_title beancounter for CT$ATTR: $STATS"
| |
| − | echo "graph_category CT$ATTR"
| |
| − | echo "graph_info 'Container bean counters info'"
| |
| − | | |
| − | readme="false"
| |
| − | cat /proc/user_beancounters | while read myid stuff; do
| |
| − | line=""
| |
| − | if [ "$myid" == "$ATTR:" ]; then
| |
| − | readme="true"
| |
| − | line="$stuff"
| |
| − | echo $line
| |
| − | else
| |
| − | loid=`echo $myid | sed -e 's/.*:/:/'`
| |
| − | if [ "$loid" == ":" ]; then
| |
| − | readme="false"
| |
| − | fi
| |
| − | if [ "$readme" == "true" ]; then
| |
| − | line="$myid $stuff"
| |
| − | echo $line
| |
| − | fi
| |
| − | fi
| |
| − | done | while read name value top warn max; do
| |
| − | okname="dummy"
| |
| − | for statname in $STATS; do
| |
| − | if [ "$name" == "$statname" ]; then
| |
| − | okname=$name
| |
| − | fi
| |
| − | done
| |
| − | | |
| − | if [ "$okname" != "dummy" ]; then
| |
| − | echo $okname.label $name
| |
| − | echo $okname.warning $warn
| |
| − | echo $okname.critical $max
| |
| − | fi
| |
| − | done
| |
| − | exit 0
| |
| − | fi;
| |
| − | | |
| − | readme="false"
| |
| − | cat /proc/user_beancounters | while read myid stuff; do
| |
| − | line=""
| |
| − | if [ "$myid" == "$ATTR:" ]; then
| |
| − | readme="true"
| |
| − | line="$stuff"
| |
| − | echo $line
| |
| − | else
| |
| − | loid=`echo $myid | sed -e 's/.*:/:/'`
| |
| − | if [ "$loid" == ":" ]; then
| |
| − | readme="false"
| |
| − | fi
| |
| − | if [ "$readme" == "true" ]; then
| |
| − | line="$myid $stuff"
| |
| − | echo $line
| |
| − | fi
| |
| − | fi
| |
| − | done | while read name value x; do
| |
| − | okname="dummy"
| |
| − | for statname in $STATS; do
| |
| − | if [ "$name" == "$statname" ]; then
| |
| − | okname=$name
| |
| − | fi
| |
| − | done
| |
| − | if [ "$okname" != "dummy" ]; then
| |
| − | echo $okname.value $value
| |
| − | fi
| |
| − | | |
| − | done
| |
| − | </source>
| |
| − | | |
| − | This is not too performant but should do and the graphs are much
| |
| − | more readable then the first solution.
| |
| − | | |
| − | | |
| − | = Extended plugin from Jan Tomasek =
| |
| − | * Jan has posted another plugin on http://forum.openvz.org/index.php?t=msg&goto=15122, where I've fixed two things:
| |
| − | *# "exit 0" in the "config" block
| |
| − | *# Replaced "vals=($str); echo ${vals[0]}" with "echo ${str%% *}" (the former was causing problems I don't remember anymore)
| |
| − | * v1.3.2 (2008/08/09)
| |
| − | *# If only 1 variable is graphed, also display maxheld, barrier and limit
| |
| − | <source lang="bash">
| |
| − | #!/bin/sh
| |
| − | #
| |
| − | # Munin's plugin to monitor OpenVZ bean counters.
| |
| − | #
| |
| − | # $Log$
| |
| − | # Revision 1.3 2007/07/19 12:57:00 Jan Tomasek <jan@tomasek.cz>
| |
| − | # * rewrited to work with /proc/bc/<VEID>/resources instead of
| |
| − | # /proc/user_beancounters, that simplified code and result
| |
| − | # is also bit faster.
| |
| − | # * added references to OpenVZ wiki
| |
| − | # Revision 1.3.1 2008/05/13 01:26:00 Daniel Hahler <http://daniel.hahler.de/>
| |
| − | # * Minor fixes
| |
| − | # - "exit 0" in "config" block
| |
| − | # - Use "echo ${str%% *}" in "suggest", instead of "vals=($str); echo ${vals[0]}"
| |
| − | #
| |
| − | # Revision 1.3.2 2008/08/09 12:30:00 Christian Rubbert <crubbert@xrc.de>
| |
| − | # * Feature
| |
| − | # - If only 1 variable is graphed, also display maxheld, barrier and limit
| |
| − | #
| |
| − | # Original revision taken from:
| |
| − | # http://wiki.openvz.org/Monitoring_openvz_resources_using_munin
| |
| − | #
| |
| − | #%# family=auto
| |
| − | #%# capabilities=autoconf suggest
| |
| − |
| |
| − | VEID=`basename $0 | sed -e 's/^vebc_.*_//'`;
| |
| − | STATS=`basename $0 | sed -e 's/^vebc_//' -e 's/_[0-9]*$//' -e 's/_/ /g'`
| |
| − | x=0; STATSCNT=`for i in $STATS; do x=$[$x+1]; done; echo $x`
| |
| − |
| |
| − | if [ "$1" = "autoconf" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | echo yes
| |
| − | exit 0
| |
| − | else
| |
| − | echo "no (/proc/bc/0/resources not found)"
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − |
| |
| − | if [ "$1" = "suggest" ]; then
| |
| − | if [ -r /proc/bc/0/resources ]; then
| |
| − | cat /proc/bc/0/resources | while read str; do
| |
| − | # Print everything before " "
| |
| − | echo ${str%% *}
| |
| − | done
| |
| − | exit 0
| |
| − | else
| |
| − | exit 1
| |
| − | fi
| |
| − | fi
| |
| − |
| |
| − | if [ ! -f /proc/bc/$VEID/resources ]; then
| |
| − | exit 0;
| |
| − | fi
| |
| − |
| |
| − | if [ "$1" = "config" ]; then
| |
| − | #echo "graph_order down up"
| |
| − | echo "graph_title VE$VEID: $STATS"
| |
| − | echo "graph_vlabel bean counters"
| |
| − | echo "graph_category VE$VEID"
| |
| − | | |
| − | # Note on URLs. General graph info is by munin version 1.2.5
| |
| − | # accepted even with HTML code. But for value.info it escapes URL,
| |
| − | # I expect that authors of munin will note that in future and put
| |
| − | # escaping even for graph.info.
| |
| − | echo "graph_info VE bean counters info. Documentation of the OpenVZ resource management is located at <a href=\"
| |
| − | http://wiki.openvz.org/UBC\">http://wiki.openvz.org/UBC</a>."
| |
| − |
| |
| − | cat /proc/bc/$VEID/resources | while read name value top warn max stuff ; do
| |
| − | for statname in $STATS; do
| |
| − | if [ "$name" = "$statname" ]; then
| |
| − | URL="http://wiki.openvz.org/$name"
| |
| − | if [ "$warn" = "0" ]; then
| |
| − | warn=$max
| |
| − | fi
| |
| − | echo $name.label $name
| |
| − | echo $name.warning $warn
| |
| − | echo $name.critical $max
| |
| − | echo $name.info Description of this resource is located at $URL
| |
| − | fi
| |
| − | done
| |
| − | done
| |
| − | | |
| − | if [ "$STATSCNT" = "1" ]; then
| |
| − | echo maxheld.label Maxheld
| |
| − | echo maxheld.draw LINE2
| |
| − | echo maxheld.info Maximum value
| |
| − | echo barrier.label Barrier
| |
| − | echo barrier.draw LINE2
| |
| − | echo barrier.info Barrier
| |
| − | echo limit.label Limit
| |
| − | echo limit.draw LINE2
| |
| − | echo limit.info Limit
| |
| − | fi
| |
| − | exit 0
| |
| − | fi;
| |
| − |
| |
| − | cat /proc/bc/$VEID/resources | while read name value top warn max stuff ; do
| |
| − | for statname in $STATS; do
| |
| − | if [ "$name" = "$statname" ]; then
| |
| − | echo $name".value "$value;
| |
| − | | |
| − | if [ "$STATSCNT" = "1" ]; then
| |
| − | echo maxheld.value $top
| |
| − | echo barrier.value $warn
| |
| − | echo limit.value $max
| |
| − | fi
| |
| − | fi
| |
| − | done
| |
| − | done</source>
| |
| − | | |
| − | = Munin plugin setup =
| |
| − | == Run as root ==
| |
| − | Please note, you have to configure plugin to run as root. Therefore, add the following to /etc/munin/plugin-conf.d/ somewhere:
| |
| − | [vebc*]
| |
| − | user root
| |
| − | | |
| − | == Installing the plugins ==
| |
| − | There's a single plugin file, which can be installed several times and can put several values into the same graph.
| |
| − | You should install the plugin from above to e.g. <code>/usr/local/share/munin/plugins/vebc_</code> and then put symlinks to there from /etc/munin/plugins.
| |
| − | The following script allows you to handle this easily:
| |
| − | To install this, you can use the following script:
| |
| − | <source lang="bash">
| |
| − | #!/bin/bash
| |
| − | | |
| − | FILE=`mktemp /tmp/ln-vebc-XXXXXX`
| |
| − | | |
| − | cd /etc/munin/plugins
| |
| − | | |
| − | for resources in kmemsize \
| |
| − | lockedpages_privvmpages_shmpages_physpages_vmguarpages_oomguarpages \
| |
| − | numproc \
| |
| − | numtcpsock_numflock_numpty_numsiginfo_numothersock_numiptent \
| |
| − | tcpsndbuf_tcprcvbuf_othersockbuf_dgramrcvbuf \
| |
| − | dcachesize \
| |
| − | numfile
| |
| − | do
| |
| − | for VE in 0 `/usr/sbin/vzlist | sed "s/^ *//" |grep '^[0-9]' | cut -f 1 -d " "` ; do
| |
| − | ln -sf /usr/local/share/munin/plugins/vebc_ "vebc_"$resources"_"$VE
| |
| − | echo "vebc_"$resources"_"$VE >> $FILE
| |
| − | done
| |
| − | done
| |
| − | | |
| − | # remove no longer deserved links (ie. links pointing to machines
| |
| − | # which were destroyed or stoped)
| |
| − | | |
| − | find -type l -name vebc_\* | sed "s/\.\///" | while read LN; do
| |
| − | if grep ^$LN$ $FILE >/dev/null; then
| |
| − | true
| |
| − | else
| |
| − | rm $LN
| |
| − | fi
| |
| − | done
| |
| − | | |
| − | rm $FILE
| |
| − | </source>
| |
| − | | |
| − | | |
| − | = Alternative: Using vzlist =
| |
| − | This simple script will generate an overview of the requested stat from all VE's.
| |
| − | When using vzlist your saved from any changes to the beancounters.
| |
| − | | |
| − | == Usage ==
| |
| − | Simply append the variable you want to monitor:
| |
| − | <source lang="bash">ln -s /usr/share/munin/plugins/openvz_ /etc/munin/plugins/openvz_physpages</source>
| |
| − | | |
| − | <source lang="bash">
| |
| − | #!/bin/sh
| |
| − | #
| |
| − | # Munin's plugin to monitor OpenVZ bean counters.
| |
| − | #
| |
| − | # $Log$
| |
| − | # 2008/08/14 Rene Weselowski <http://www.dead.at>
| |
| − | #
| |
| − | #%# family=auto
| |
| − | #%# capabilities=autoconf
| |
| − | | |
| − | ATTRIBUTE=`basename $0 | sed 's/^openvz_//g'`
| |
| − | | |
| − | | |
| − | if [ "$1" = "autoconf" ]; then
| |
| − | echo yes
| |
| − | exit 0
| |
| − | fi
| |
| − | | |
| − | if [ "$1" = "config" ]; then
| |
| − | echo "graph_title $ATTRIBUTE"
| |
| − | echo "graph_args --base 1000 -l 0"
| |
| − | echo "graph_scale yes"
| |
| − | echo "graph_vlabel $ATTRIBUTE Value"
| |
| − | echo "graph_category openvz"
| |
| − | echo "graph_info This graph shows OpenVZ: $ATTRIBUTE"
| |
| − | vzlist -a -H -o hostname | awk '{gsub(/\./,"_",$1)
| |
| − | print("'$ATTRIBUTE'"$1".label "$1"\n" \
| |
| − | "'$ATTRIBUTE'"$1".info '$ATTRIBUTE' for VE"$1)}'
| |
| − | exit 0
| |
| − | fi
| |
| − | | |
| − | vzlist -a -H -o hostname,$ATTRIBUTE | awk '{gsub(/\./,"_",$1)
| |
| − | print("'$ATTRIBUTE'"$1".value "$2)}'
| |
| − | | |
| − | </source>
| |
