Editing Monitoring openvz resources using munin

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
 
[[Category: Monitoring]]
 
[[Category: Monitoring]]
  
−
[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.
+
{{wikify}}
  
−
[http://exchange.munin-monitoring.org/plugins/openvz_/details A second is also available via the Munin plugin exchange] which tracks beancounter values.
+
== munin plugin ==
−
 
 
−
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 =
 
  
 
The plugin listed below grabs all the beancounters' values.
 
The plugin listed below grabs all the beancounters' values.
Line 34: Line 29:
  
 
if [ "$1" = "suggest" ]; then
 
if [ "$1" = "suggest" ]; then
 +
 
         if [ -r /proc/bc/0/resources ]; then
 
         if [ -r /proc/bc/0/resources ]; then
 
             cat /proc/bc/0/resources |
 
             cat /proc/bc/0/resources |
 
             while read str; do
 
             while read str; do
 +
 
                 vals=($str)
 
                 vals=($str)
 
                 echo ${vals[0]}
 
                 echo ${vals[0]}
 
             done
 
             done
 +
 
                 exit 0
 
                 exit 0
 
         else
 
         else
Line 45: Line 43:
 
         fi
 
         fi
 
fi
 
fi
 +
  
 
if [ "$1" = "config" ]; then
 
if [ "$1" = "config" ]; then
 +
 
#      echo "graph_order down up"
 
#      echo "graph_order down up"
−
         echo "graph_title $ATTR beancounter for containers"
+
         echo "graph_title $ATTR beancounter for VE's"
 
         echo 'graph_category system'
 
         echo 'graph_category system'
−
         echo "graph_info 'Containers beancounters info'"
+
         echo "graph_info 'VE bean counters info'"
 +
 
  
 
         for CTID in `ls -d1 /proc/bc/???`; do
 
         for CTID in `ls -d1 /proc/bc/???`; do
Line 68: Line 69:
 
fi;
 
fi;
  
−
for CTID in `ls -d1 /proc/bc/???`; do
+
 
−
    id=`basename $CTID`
+
        for CTID in `ls -d1 /proc/bc/???`; do
−
    grep $ATTR $CTID/resources |
+
            id=`basename $CTID`
−
    while read str; do
+
            grep $ATTR $CTID/resources |
−
        vals=($str)
+
            while read str; do
−
        name=${vals[0]}
+
 
−
        echo "$id.value ${vals[1]}"
+
                vals=($str)
−
    done
+
                name=${vals[0]}
−
done
+
                echo "$id.value ${vals[1]}"
 +
            done
 +
        done
 +
 
 
</source>
 
</source>
  
−
= Extended Version for old system using user_beancounter =
+
Please note, you have to configure plugin to run as root:
 +
 
 +
<code>
 +
[vebc*]
 +
user root
 +
</code>
 +
 
 +
at /etc/munin/plugin-conf.d/ somewhere.
 +
 
 +
 
 +
Extended Version for old system using user_beancounter.
  
 
Put it with the munin plugins and make a link for every
 
Put it with the munin plugins and make a link for every
Line 111: Line 125:
  
 
if [ "$1" = "suggest" ]; then
 
if [ "$1" = "suggest" ]; then
 +
 
         if [ -r /proc/bc/0/resources ]; then
 
         if [ -r /proc/bc/0/resources ]; then
 
             cat /proc/bc/0/resources |
 
             cat /proc/bc/0/resources |
 
             while read str; do
 
             while read str; do
 +
 
                 vals=($str)
 
                 vals=($str)
 
                 echo ${vals[0]}
 
                 echo ${vals[0]}
 
             done
 
             done
 +
 
                 exit 0
 
                 exit 0
 
         else
 
         else
Line 124: Line 141:
  
 
if [ "$1" = "config" ]; then
 
if [ "$1" = "config" ]; then
 +
 
#      echo "graph_order down up"
 
#      echo "graph_order down up"
−
         echo "graph_title beancounter for CT$ATTR: $STATS"
+
         echo "graph_title beancounter for VE$ATTR: $STATS"
−
         echo "graph_category CT$ATTR"
+
         echo "graph_category VE$ATTR"
−
         echo "graph_info 'Container bean counters info'"
+
         echo "graph_info 'VE bean counters info'"
  
 
         readme="false"
 
         readme="false"
 
         cat /proc/user_beancounters | while read myid stuff; do
 
         cat /proc/user_beancounters | while read myid stuff; do
 +
 
                 line=""
 
                 line=""
 +
 
                 if [ "$myid" == "$ATTR:" ]; then
 
                 if [ "$myid" == "$ATTR:" ]; then
 +
 
                         readme="true"
 
                         readme="true"
 
                         line="$stuff"
 
                         line="$stuff"
 
                         echo $line
 
                         echo $line
 
                 else
 
                 else
 +
 
                         loid=`echo $myid | sed -e 's/.*:/:/'`
 
                         loid=`echo $myid | sed -e 's/.*:/:/'`
 +
 
                         if [ "$loid" == ":" ]; then
 
                         if [ "$loid" == ":" ]; then
 +
 
                                 readme="false"
 
                                 readme="false"
 
                         fi
 
                         fi
 
                         if [ "$readme" == "true" ]; then
 
                         if [ "$readme" == "true" ]; then
 +
 
                                 line="$myid $stuff"
 
                                 line="$myid $stuff"
 
                         echo $line
 
                         echo $line
 
                         fi
 
                         fi
 
                 fi
 
                 fi
 +
 
         done | while read name value top warn max; do
 
         done | while read name value top warn max; do
 +
 
                 okname="dummy"
 
                 okname="dummy"
 +
 
                 for statname in $STATS; do
 
                 for statname in $STATS; do
 +
 
                         if [ "$name" == "$statname" ]; then
 
                         if [ "$name" == "$statname" ]; then
 +
 
                                 okname=$name
 
                                 okname=$name
 
                         fi
 
                         fi
 +
 
                 done
 
                 done
  
 
                 if [ "$okname" != "dummy" ]; then
 
                 if [ "$okname" != "dummy" ]; then
 +
 
                         echo $okname.label $name
 
                         echo $okname.label $name
 
                         echo $okname.warning $warn
 
                         echo $okname.warning $warn
Line 160: Line 192:
 
                 fi
 
                 fi
 
         done
 
         done
 +
 
         exit 0
 
         exit 0
 
fi;
 
fi;
 +
  
 
readme="false"
 
readme="false"
 
cat /proc/user_beancounters | while read myid stuff; do
 
cat /proc/user_beancounters | while read myid stuff; do
 +
 
         line=""
 
         line=""
 +
 
         if [ "$myid" == "$ATTR:" ]; then
 
         if [ "$myid" == "$ATTR:" ]; then
 +
 
                 readme="true"
 
                 readme="true"
 
                 line="$stuff"
 
                 line="$stuff"
 
                 echo $line
 
                 echo $line
 
         else
 
         else
 +
 
                 loid=`echo $myid | sed -e 's/.*:/:/'`
 
                 loid=`echo $myid | sed -e 's/.*:/:/'`
 +
 
                 if [ "$loid" == ":" ]; then
 
                 if [ "$loid" == ":" ]; then
 +
 
                         readme="false"
 
                         readme="false"
 
                 fi
 
                 fi
 +
 
                 if [ "$readme" == "true" ]; then
 
                 if [ "$readme" == "true" ]; then
 +
 
                         line="$myid $stuff"
 
                         line="$myid $stuff"
 
                 echo $line
 
                 echo $line
Line 181: Line 223:
 
         fi
 
         fi
 
done | while read name value x; do
 
done | while read name value x; do
 +
 
         okname="dummy"
 
         okname="dummy"
 +
 
         for statname in $STATS; do
 
         for statname in $STATS; do
 +
 
                 if [ "$name" == "$statname" ]; then
 
                 if [ "$name" == "$statname" ]; then
 +
 
                         okname=$name
 
                         okname=$name
 
                 fi
 
                 fi
 
         done
 
         done
 +
 
         if [ "$okname" != "dummy" ]; then
 
         if [ "$okname" != "dummy" ]; then
 +
 
                 echo $okname.value $value
 
                 echo $okname.value $value
 
         fi
 
         fi
  
 
done
 
done
 +
 
</source>
 
</source>
  
 
This is not too performant but should do and the graphs are much
 
This is not too performant but should do and the graphs are much
 
more readable then the first solution.
 
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>
 

Please note that all contributions to OpenVZ Virtuozzo Containers Wiki may be edited, altered, or removed by other contributors. If you don't want your writing to be edited mercilessly, then don't submit it here.
 If you are going to add external links to an article, read the External links policy first!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)
Retrieved from "https://wiki.openvz.org/Monitoring_openvz_resources_using_munin"