Munin contributed plugins

#!/bin/sh

###################################################################################################

#

# Multigraph munin plugin to monitor 2wcom DSR01/DSR02 Professional Audio Satellite-Receivers 

# through their web interface status page.

#

# To use this plugin, copy it to the munin's plugin directory (eg. /usr/share/munin/plugins)

# under the name "2wcomdsr_". Don't change this filename! Follow these steps:

#

# 1. Give names to your receivers, in fqdn style. Like "dvbs.radio1" or "dvbs.radio2". Make sure

#    you can resolve these names as DNS names from the munin machine. You can simply add them

#    as entries in /etc/hosts.

#

# 2. Then symlink it to munin's configured plugins directory (eg. /etc/munin/plugins) with names

#    according to the devices you wish to monitor, eg:

#

#    2wcomdsr_dvbs.radio1

#    2wcomdsr_dvbs.radio2

#

# 3. In  /etc/munin/munin.conf just add these lines for them. Yes, 127.0.0.1 is correct

#    because that points to the munin-node address not the UPS address.

#

#    [2wcomdsr_dvbs.radio1]

#	address 127.0.0.1

#

#    [2wcomdsr_dvbs.radio2]

#	address 127.0.0.1

#

# 4. In /etc/munin/plugin-conf.d/munin-node add the web interface login, to be able to read

#    the reveivers status pages (obviously replacing these with your own data):

#

#    [2wcomdsr_*]

#    env.webuser admin

#    env.webpass admin

#

#    The above is for all the receivers using the same username and password. If they are different

#    you can add as many entries as you want, by removing the wildcard and giving the entire name.

#

# 5. Restart the munin node by 'service munin-node restart'.

#

#    If all went well, after 5 minutes or so you should have two additional nodes listed

#    on the Web Interface of munin.

#

# Tested & working with several 2wcom DSR01 Basic receivers, with Munin v.2.0.14 on Ubuntu LTS 12.04

# Created in 2013 by robi

#  v0.2 - added Viterbi/LDPC and RS/BCH BER graphs

#  v0.1 - initial version

##################################################################################################

case $0 in

    *2wcomdsr_*)

	hostname=${0##*/2wcomdsr_}

	;;

esac

case $1 in

   config)

echo "multigraph cpn"

echo "host_name $hostname"

echo "graph_args --base 1000"

echo "graph_title Carrier/Noise Ratio"

echo "graph_vlabel dB"

echo "graph_category status"

echo "graph_scale no"

echo "graph_info Calculated carrier/noise ratio of the signal. To avoid data errors, the decoding of a received signal requires a minimum C/N ratio that depends on the FEC rate."

echo "cpn.label C/N"

echo "cpn.critical 10:"

echo "cpn.info Calculated carrier/noise ratio of the signal."

echo

echo "multigraph cfo"

echo "host_name $hostname"

echo "graph_args --base 1000"

echo "graph_title Carrier Frequency Offset"

echo "graph_vlabel MHz"

echo "graph_category status"

echo "graph_scale no"

echo "graph_info Incoming signals from the LNB are subject to frequency tolerances, thus check the 'CFO Error' under menu item 'Status>Tuner'. This value represents the margin by which the entered frequency deviates from the actual frequency. In order to maximize reception quality the CFO error should be minimized."

echo "cfo.label CFO"

echo "cfo.critical 250"

echo "cfo.info Carrier Frequency Offset."

echo

echo "multigraph inp"

echo "host_name $hostname"

echo "graph_args --base 1000"

echo "graph_title RF Signal Level"

echo "graph_vlabel dBm"

echo "graph_category status"

echo "graph_scale no"

echo "graph_info Input for the connection of the receiving LNB of the satellite antenna. Admissible RF signal input range is -82 to -10 dBm."

echo "inp.label RF level"

echo "inp.critical -65:"

echo "inp.info Level of the RF signal at the 'RF-In' input."

echo

echo "multigraph tnr"

echo "host_name $hostname"

echo "graph_args --base 1000"

echo "graph_title Tuner system Status"

echo "graph_vlabel 1=OK, 0=BAD"

echo "graph_category status"

echo "graph_scale no"

echo "graph_info Tuner system status: 1 = 'OK' or 0 = 'BAD'. It is OK if all the following values are OK: AGC (Automatic Gain Control), CE (Carrier Frequency Offset Estimation), Symbol Timing, Carrier Locked, Viterbi error correction."

echo "tnr.label Tuner status"

echo "tnr.critical 1:"

echo "tnr.info Tuner system status: 1 = 'OK' or 0 = 'BAD'."

echo

echo "multigraph led2"

echo "host_name $hostname"

echo "graph_args --base 1000"

echo "graph_title Warning LED"

echo "graph_vlabel 0=OFF; >0=ON"

echo "graph_category status"

echo "graph_scale no"

echo "graph_info Every monitoring function has a checkbox 'warning LED on' to select if the 'Warning' LED on the web interface and the front panel of the device is activated on alarms or not."

echo "ld2.label Warning"

echo "ld2.critical 1"

echo "ld2.info Warning LED: 0 = OFF, greater than 0 = ON."

echo

echo "multigraph ber_vt"

echo "host_name $hostname"

echo "graph_args --base 1000 --logarithmic"

echo "graph_title BER Viterbi/LDPC"

echo "graph_vlabel Bit Error Rate"

echo "graph_category status"

#echo "graph_scale no"

echo "graph_info Detected bit error rate (BER) before the Viterbi error correction."

echo "ber_vt.label Viterbi/LDPC BER"

echo "ber_vt.critical 0.0002"

echo "ber_vt.info BER before Viterbi error correction"

echo

echo "multigraph ber_rs"

echo "host_name $hostname"

echo "graph_args --base 1000 --logarithmic"

echo "graph_title BER Reed Solomon/BCH"

echo "graph_vlabel Bit Error Rate"

echo "graph_category status"

#echo "graph_scale no"

echo "graph_info Detected bit error rate (BER) before the Reed Solomon error correction."

echo "ber_rs.label RS/BCH BER"

echo "ber_rs.critical 0.0002"

echo "ber_rs.info BER before Reed Solomon error correction"

echo 

	exit 0;;

esac

statusfile=/tmp/2wcomdsr_munin_$hostname.html

wget -O $statusfile --user=$webuser --password=$webpass http://$hostname/stattuner.xml -o /dev/null --timeout 9

if [ -f "$statusfile" ]

then

	cpn=`grep 'content_1<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_1//g;s/dB//g;s/ //g'`

	cfo=`grep 'content_2<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_2//g;s/MHz//g;s/ //g'`

	inp=`grep 'content_3<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_3//g;s/dBm//g;s/ //g'`

	tnr=`grep 'content_10<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_10//g;s/ //g'`

	ld2=`grep 'led_2<' $statusfile | sed 's/<[^>]*>//g' | sed 's/led_2//g;s/ //g'`

	bev=`grep 'content_12<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_12//g;s/ //g'`

	bes=`grep 'content_13<' $statusfile | sed 's/<[^>]*>//g' | sed 's/content_13//g;s/ //g'`

	rm -f $statusfile

fi

echo "multigraph cpn"

echo -n "cpn.value "

if [ -n "$cpn" ]; then

	echo "$cpn"

else

	echo "U"

fi

echo

echo "multigraph cfo"

echo -n "cfo.value "

if [ -n "$cfo" ]; then

	echo "$cfo"

else

	echo "U"

fi

echo

echo "multigraph inp"

echo -n "inp.value "

if [ -n "$inp" ]; then

	echo "$inp"

else

	echo "U"

fi

echo

echo "multigraph tnr"

echo -n "tnr.value "

if [ -n "$tnr" ]; then

	case "$tnr" in

		"OK" ) echo "1";;

		"BAD" ) echo "0";;

	esac

else

	echo "U"

fi

echo

echo "multigraph led2"

echo -n "ld2.value "

if [ -n "$ld2" ]; then

	echo "$ld2"

else

	echo "U"

fi

echo

echo "multigraph ber_vt"

echo -n "ber_vt.value "

if [ -n "$bev" ]; then

        case "$bev" in

                "--" ) echo "U";;

                * ) printf %.8f $bev && echo;;

        esac

else

        echo "U"

fi

echo

echo "multigraph ber_rs"

echo -n "ber_rs.value "

if [ -n "$bes" ]; then

        case "$bes" in

                "--" ) echo "U";;

                * ) printf %.8f $bes && echo;;

        esac

else

        echo "U"

fi

echo