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

if_uptime

Sadly there is no documentation for this plugin

#!/bin/bash
# This script is intended for use with Munin to monitor
# network interface uptime. Usually this would be ppp0 or smth.
# Tested under Ubuntu Gutsy.
# v. 1.00, 12/15/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/if_uptime
# 2. Customize interfaces to monitor
# 3. Make executable: "chmod 755 /usr/share/munin/plugins/if_uptime"
# 4. Run "munin-node-configure --shell", you should see smth like
# "ln -s /usr/share/munin/plugins/if_uptime /etc/munin/plugins/if_uptime"
# Multiple interface monitoring is supported as well. Customize below.
# 5. Run the proposed command to create a link.
# 6. To verify, run "munin-node-configure", you should notice the "if_uptime" record
#
# Plugin                     | Used | Suggestions
# ------                     | ---- | -----------
# if_uptime                  | yes  |
#
# 7. Restart munin: "/etc/init.d/munin-node restart"
# 8. Hold on for 5 minutes at most and watch the graph appear.
#
#%# family=contrib
#%# capabilities=autoconf

#----- PROPERTIES START -----#
# An array of external interfaces to monitor, space-separated.
# In case vnstat is installed, interface names will be fetced
# from it, 'nicknames'included.
INTERFACES=(ppp0)

# Uptime metrics.
# Literals of seconds, minutes, hours and days are accepted.
METRICS=minutes
#----- PROPERTIES END -----#

# Function to get interface name from vnstat if it's available.
# Accepts interface name as the only argument.
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
}

# Converts seconds (uptime value) into desired metrics value.
# Accepts uptime value as the only argument. Relies on the
# METRICS variable set above.
function SECONDS_CONVERTER() {
	ARG=$1
		case $METRICS in
	seconds)
		echo "$ARG"
		;;
	minutes)
		echo $((ARG / 60))
		;;
	days)
		echo $((ARG / 86400))
		;;
	hours)
		echo $((ARG / 3600))
		;;
	*)
		echo "value value"
		exit 1
		;;
	esac
}

# Helper function that collects and stores data.
# Accepts interface name as the only argument.
function FETCH_DATA() {

IF="$1"
# File to store data between rounds. Per-line values:
# bytes received
# timestamp
# total uptime
FILE=/tmp/if_uptime_"$IF"

if [[ !(-e "$FILE") ]]
	then
		cat > $FILE << EOF
0
$(date +%s)
0
EOF
fi
# Read previous values
		previous_received=$(head -n 1 < $FILE)
		previous_timestamp=$(head -n 2 < $FILE | tail -n 1)
		previous_uptime=$(tail -n 1 < $FILE)
# Get current values
		current_received=$(grep "$IF" < /proc/net/dev | sed 's|: *|:|g' | cut -d":" -f2 | cut -d" " -f1)
		current_timestamp=$(date +%s)
# Evaluate whether interface went down
		if [[ $current_received -gt $previous_received ]]
			then
				current_uptime=$(( $previous_uptime+($current_timestamp-$previous_timestamp) ))
			else
				current_uptime="0"
		fi
# Write new values
		cat > $FILE << EOF
$current_received
$current_timestamp
$current_uptime
EOF

}
# Munin routines
	case "$1" in
		autoconf)
			if [[ $(ifconfig &> /dev/null; echo "$?") == 0 ]]; then
				echo yes
			else
				echo "no (ifconfig doesn't work out)"
			fi
			exit 0
		;;
		config)
cat << EOM
graph_title Interface Uptime Meter
graph_category network
graph_info Get to know how often your ISP violates SLA.
graph_vlabel Interface uptime, $METRICS
graph_args --base 1000 --lower-limit 0
EOM
			for (( i=0; i<"${#INTERFACES[*]}"; i++ ))
				do
cat << EOM
${INTERFACES[$i]}.draw LINE3
${INTERFACES[$i]}.label $(IF_NAME ${INTERFACES[$i]})
EOM
				done
			exit 0
		;;
			*)
# Print data for Munin
			for (( i=0; i<"${#INTERFACES[*]}"; i++ ))
				do
					FETCH_DATA ${INTERFACES[$i]}
					echo "${INTERFACES[$i]}.value $(SECONDS_CONVERTER $current_uptime)"
				done
			exit 0
		;;
		esac