Munin contributed plugins

#!/bin/sh

#

# Plugin to monitor the load average on a system.

#

# Usage: Link or copy into /etc/munin/node.d/

#

# $Log$

# Revision 1.5  2004/05/20 19:02:37  jimmyo

# Set categories on a bunch of plugins

#

# Revision 1.4  2004/05/20 13:57:12  jimmyo

# Set categories to some of the plugins.

#

# Revision 1.3  2004/05/16 12:41:04  jimmyo

# Changed load plot from lastminute to last 5 minutes.

#

# Revision 1.2  2004/05/16 12:34:26  jimmyo

# Added "info"-fields to linux/cpu and linux/load plugins, to demonstrate how it works.

#

# Revision 1.1  2004/01/02 18:50:01  jimmyo

# Renamed occurrences of lrrd -> munin

#

# Revision 1.1.1.1  2004/01/02 15:18:07  jimmyo

# Import of LRRD CVS tree after renaming to Munin

#

# Revision 1.4  2003/11/15 11:10:28  jimmyo

# Various fixes

#

# Revision 1.3  2003/11/07 17:43:16  jimmyo

# Cleanups and log entries

#

#

#

# Magic markers (optional - only used by munin-config and some

# installation scripts):

#

#%# family=auto

#%# capabilities=autoconf

# If run with the "autoconf"-parameter, give our opinion on whether we

# should be run on this system or not. This is optinal, and only used by

# munin-config. In the case of this plugin, we should most probably

# always be included.

if [ "$1" = "autoconf" ]; then

	echo yes

	exit 0

fi

# If run with the "config"-parameter, give out information on how the

# graphs should look.

if [ "$1" = "config" ]; then

	# The host name this plugin is for. (Can be overridden to have

	# one machine answer for several)

	# The title of the graph

	echo 'graph_title Load average'

	# Arguments to "rrdtool graph". In this case, tell it that the

	# lower limit of the graph is '0', and that 1k=1000 (not 1024)

	echo 'graph_args --base 1000 -l 0'

	# The Y-axis label

	echo 'graph_vlabel load'

	# We want Cur/Min/Avg/Max unscaled (i.e. 0.42 load instead of

	# 420 milliload)

	echo 'graph_scale no'

	# Graph category. Defaults to 'other'

	echo 'graph_category system'

	# The fields. "label" is used in the legend. "label" is the only

	# required subfield.

	echo 'load1.label load 1 min avg'

	echo 'load1.draw AREA'

	echo 'load5.label load 5 min avg'

	echo 'load5.draw AREA'

	echo 'load15.label load 15 min avg'

	echo 'load15.draw AREA'

	# These 6 are optional. They are only used if you have

	# configured your munin to tell a Nagios-server about any

	# problems

	echo 'load1.warning 10'

	echo 'load1.critical 120'

	echo 'load5.warning 10'

	echo 'load5.critical 120'

	echo 'load15.warning 10'

	echo 'load15.critical 120'

	# This one is purely to add an explanation to the web page. The first

	# one is for the graph itself, while the second one is for the field

	# "load".

	echo 'graph_info The load average of the machine describes how many processes are in the run-queue (scheduled to run "immediately").'

	echo 'load1.info Average load for 1 minute avg.'

	echo 'load5.info Average load for 5  minutes avg.'

	echo 'load15.info Average load for 15 minutes avg.'

	# Last, if run with the "config"-parameter, quit here (don't

	# display any data)

	exit 0

fi

# If not run with any parameters at all (or only unknown ones), do the

# real work - i.e. display the data. Almost always this will be

# "value" subfield for every data field.

echo -n "load1.value "

cut -f1 -d' ' < /proc/loadavg

echo -n "load5.value "

cut -f2 -d' ' < /proc/loadavg

echo -n "load15.value "

cut -f3 -d' ' < /proc/loadavg

# How could this plugin have been written in its simplest form?

# Something like this:

#

# ---------------------

# #!/bin/sh

#

# if [ "$1" = "config" ]; then

# 	echo "graph_title Load average"

#	echo 'graph_args --base 1000 -l 0'

#	echo 'graph_vlabel load'

# 	echo "load.label load"

# 	exit 0

# fi

# echo -n "load.value "

# cut -f1 -d' ' < /proc/loadavg

# ---------------------

#

# Except for the Nagios-warnings (which most people don't have any need

# for) and things used by installation scripts and munin-config (which

# you don't need if you don't plan on submitting your plugin to the

# pacakge), and the scaling (no milliload numbers) the two versions will

# work identically.