Repository
Munin (contrib)
Last change
2018-09-16
Graph Categories
Family
contrib
Capabilities
Keywords
Language
Bash
Authors

pinger

Sadly there is no documentation for this plugin.

#!/bin/bash
# This script is intended for use with Munin to monitor
# ping response time from hosts and through interfaces specified.
# v. 1.1, 12/16/2007
# (c) Alex Yanchenko (yanchenko{at}gmail.com), 2007
# Distributed under GPL v.3 (http://www.gnu.org/licenses/gpl-3.0.txt)
#
# The plugin can utilize automatic configuration,
# here are the basic steps (require root privileges):
# 1. Copy it as /usr/share/munin/plugins/pinger
# 2. Make executable: "chmod 755 /usr/share/munin/plugins/pinger"
# 3. Customize hosts, interfaces and ping count below
# 4. As pinging takes much time, add a
# --
# [pinger]
# timeout 60
# --
# record to /etc/munin/munin-node.conf to avoid timeouts.
# 5. Run "munin-node-configure --shell", you should see smth like
# "ln -s /usr/share/munin/plugins/pinger /etc/munin/plugins/pinger"
# 6. Run the proposed command to create a link.
# 7. To verify, run "munin-node-configure", you should notice the "pinger" record
#
# Plugin                     | Used | Suggestions
# ------                     | ---- | -----------
# pinger                     | yes  |
#
# 8. Restart munin: "/etc/init.d/munin-node restart"
# 9. Hold on for 5 minutes at most and watch the graphs appear.
#
#%# family=contrib
#%# capabilities=autoconf

#----- PROPERTIES START -----#
# An array of interfaces to ping through, space-separated.
# In case vnstat is installed, interface names will be fetced
# from it, 'nicknames'included.
INTERFACE=(eth2 eth3)

# An array of hosts to ping, space-separated.
HOST=(dc.volia.com hosting.rbc.ru slicehost.com)

# Ping count, higher values lead to more precise
# results yet take more time
PING=3
#----- PROPERTIES END -----#

# Try to get interface name from vnstat, make sure the name is assigned
function IF_NAME() {
        ARG=$1
        if [[ $(which vnstat &>/dev/null; echo $?) == 0 ]]
                then
                        IF_NAME="$(vnstat | grep "$ARG" | cut -d" " -f2,3 | cut -d":" -f1)"
                else
                        IF_NAME="$ARG"
        fi
        echo $IF_NAME
}

# Ping given host through a given interface
function PINGER() {
        ping $2 -c${PING} -I$1 | grep "rtt min/avg/max/mdev" | cut -d" " -f4 | cut -d"/" -f2 | cut -d"." -f1
}

case $1 in
	autoconf)
		which ping
	       	if [[ "$?" = "0" ]]; then
	               	echo yes
	       	else
	               	echo "no (ping not present)"
	       	fi
		exit 0
		;;
        config)
cat << EOM
graph_title Pinger
graph_category network
graph_info A nice thingy to ping remote hosts.
graph_vlabel msec
graph_args --base 1000 --lower-limit 0
EOM
                        for (( i=0; i<"${#HOST[*]}"; i++ ))
                                do
                                        for (( j=0; j<"${#INTERFACE[*]}"; j++ ))
                                                do
                                                        echo "${j}_${i}.label $(IF_NAME ${INTERFACE[$j]}) - ${HOST[$i]}"
                                        done
                        done
                ;;
        *)
                        for (( i=0; i<"${#HOST[*]}"; i++ ))
                                do
                                        for (( j=0; j<"${#INTERFACE[*]}"; j++ ))
                                                do
                                                        echo "${j}_${i}.value $(PINGER ${INTERFACE[$j]} ${HOST[$i]})"
                                                done
                                done
                ;;
esac