Munin contributed plugins

#!/bin/sh

# -*- sh -*-

: << =cut

=head1 NAME

freeipmi_ - Plugin to monitor temperature or fan speed using FreeIPMI

=head1 CONFIGURATION

=head2 ENVIRONMENT VARIABLES

When used to monitor a foreign host, this plugins use the variables

IPMI_USERNAME and IPMI_PASSWORD to log in on the remote system.

=head2 WILDCARD PLUGIN

You can monitor either the current system (via /dev/ipmi0 and the

like) or a remote system (via the LAN protocols), and for each of the

two options you can select your sensors:

 - fans;

 - temp;

 - power;

 - current;

 - voltage.

When used for the local host, the plugin should be linked as, e.g.,

'ipmi_temp', whereas when used to monitor a foreign host it should be,

e.g., 'ipmi_192.168.0.253_temp'.

=head1 NOTE

=head1 AUTHOR

Rewritten by Diego Elio Pettenò <flameeyes@flameeyes.eu>.

Based on the work of Nicolai Langfeldt <janl@linpro.no>, Logilab and

Peter Palfrader.

=head1 LICENSE

GPLv2

=head1 MAGIC MARKERS

 #%# family=auto

 #%# capabilities=autoconf suggest

=cut

#### Parse commandline to determine what the job is

_ipmisensors() {

    params="--quiet-cache --comma-separated-output --no-header-output --ignore-not-available-sensors"

    if [ "x${hostname}" != "x" ]; then

	params="${params} --hostname=${hostname}"

	[ "x${IPMI_USERNAME}" != "x" ] && params="${params} --username=${IPMI_USERNAME}"

	[ "x${IPMI_PASSWORD}" != "x" ] && params="${params} --password=${IPMI_PASSWORD}"

    fi

    if ! ipmi-sensors ${params} --output-sensor-thresholds "$@"; then

	ipmi-sensors ${params} "$@"

    fi

}

# extract and eventual hostname out of the called name; we

# have to check whether it's set to "u" as that's what happens

# when the compatibility with ipmi_sensor_ is used.

hostname1=${0#*_}

hostname=${hostname1%%_*}

if [ "x${hostname}" = "xu" -o "x${hostname}" = "x${hostname1}" ]; then

    hostname=""

fi

case $0 in

    *_temp|*_u_degrees_c)

	title="Temperatures"

	vlabel="degrees Celsius"

	type=Temperature

	unit=C

	;;

    *_fans|*_u_rpm)

	title="Fan speeds"

	vlabel="Rotations per Minute (RPM)"

	type=Fan

	unit=RPM

	;;

    *_power|*_u_watts)

	title="Power consumption"

	vlabel="Watts"

	type=Current

	unit=W

	;;

    *_current|*_u_amps)

	title="Current drain"

	vlabel="Amperes"

	type=Current

	unit=A

	;;

    *_voltage|*_u_volts)

	title="Voltages"

	vlabel="Volts"

	type=Voltage

	unit=V

	;;

    *)

	if [ x"$1" != x"autoconf" -a x"$1" != x"suggest" ]; then

	    echo "Please invoke as one of the supported sensors types:" >&2

	    echo freeipmi_{temp,fans,power,current} >&2

	    exit 1

	fi

esac

case $1 in

    autoconf)

	if ! command -v ipmi-sensors >/dev/null 2>&1 ; then

	    echo 'no (missing ipmi-sensors command)'

	    exit 0

	fi

	if ! _ipmisensors -t OS_Boot >/dev/null 2>&1 ; then

	    echo 'no (unable to access IPMI device)'

	    exit 0

	fi

	echo yes

	exit 0

	;;

    suggest)

	_ipmisensors | awk -F, '

$3 == "Temperature" { print "temp"; }

$3 == "Fan" { print "fans"; }

$3 == "Current" && $5 == "W" { print "power"; }

$3 == "Current" && $5 == "A" { print "current"; }

$3 == "Voltage" { print "voltage"; }

'

	exit 0;;

    config)

	cat - <<EOF

graph_title ${title} based on IPMI sensors

graph_vlabel ${vlabel}

graph_category Sensors

EOF

	if [ "x${hostname}" != "x" ]; then

	    echo "host_name ${hostname}"

	fi

	;;

esac

_ipmisensors -t ${type} | awk -F, -v CONFIG=$1 -v UNIT=$unit '

$5 == UNIT {

    if ( CONFIG != "config" ) {

      printf("ipmi%s.value %s\n", $1, $4);

    } else {

      printf("ipmi%s.label %s\n", $1, $2);

      # This can only happen if FreeIPMI is new enough

      if ( NF == 12 ) {

        if ( $8 != "N/A" && $10 != "N/A" )

          printf("ipmi%s.warning %s:%s\n", $1, $8, $10);

        else if ( $8 == "N/A" && $10 != "N/A" )

          printf("ipmi%s.warning :%s\n", $1, $10);

        else if ( $8 != "N/A" && $10 == "N/A" )

          printf("ipmi%s.warning %s:\n", $1, $8);

        if ( $7 != "N/A" && $11 != "N/A" )

          printf("ipmi%s.critical %s:%s\n", $1, $7, $11);

        else if ( $7 == "N/A" && $11 != "N/A" )

          printf("ipmi%s.critical :%s\n", $1, $11);

        else if ( $7 != "N/A" && $11 == "N/A" )

          printf("ipmi%s.critical %s:\n", $1, $7);

      }

  }

}

'

# vim: syntax=sh ts=4 et