Repository
Munin (2.0)
Last change
2020-05-27
Family
auto
Capabilities
Language
Shell
Authors

apc_envunit_

Name

apc_envunit_ - plugin to monitor temperature and humidity

Applicable Systems

Hosts which can use SNMP to connect to an APC environmental unit

Configuration

The following environment variables are available

units     - DNS names of environmental units
oid       - OID Prefix for humidity probes
community - SNMP community to use to access the APC unit

The following shows a typical configuration:

[apc_envunit_*]
  env.units foo.example.org bar.example.org
  env.community 123secret

Interpretation

Shows a graph with either temperature or humidity for a number of environmental units.

Magic Markers

#%# family=auto
#%# capabilities=autoconf suggest

Bugs

None known. Should be snmp__apc_.

Author

Xavier Redon

License

Unknown

#!@@GOODSH@@
# -*- sh -*-

: << =cut

=head1 NAME

apc_envunit_ - plugin to monitor temperature and humidity

=head1 APPLICABLE SYSTEMS

Hosts which can use SNMP to connect to an APC environmental unit

=head1 CONFIGURATION

The following environment variables are available

 units     - DNS names of environmental units
 oid       - OID Prefix for humidity probes
 community - SNMP community to use to access the APC unit

The following shows a typical configuration:

 [apc_envunit_*]
   env.units foo.example.org bar.example.org
   env.community 123secret

=head1 INTERPRETATION

Shows a graph with either temperature or humidity for a number of
environmental units.

=head1 MAGIC MARKERS

 #%# family=auto
 #%# capabilities=autoconf suggest

=head1 BUGS

None known. Should be snmp__apc_.

=head1 AUTHOR

Xavier Redon

=head1 LICENSE

Unknown

=cut

type=$(echo "$0" | sed -e 's/.*_\(.*\)/\1/')
if [ "${type}" = temperature ] ; then
  TOID="enterprises.318.1.1.10.3.13.1.1.3"
  NAME="temperature"
  LABEL="Celsius Degrees"
  LETTER="t"
else
  if [ "${type}" = humidity ] ; then
   TOID="enterprises.318.1.1.10.3.13.1.1.6"
   NAME="humidity"
   LABEL="Humidity %"
   LETTER="h"
  fi
fi

UNITS=${units:-}
COMMUNITY=${community:-public}
SNMPGET=$(command -v snmpget)

if [ -n "${oid:-}" ]; then TOID=$oid ; fi


snmp_get() {
  "$SNMPGET" -Ov -Oq -v1 -c "$COMMUNITY"
}


if [ "$1" = "autoconf" ]; then
  if [ -z "${UNITS}" ] ; then echo "no (no units to monitor)" ; exit 0 ; fi
  if [ -z "$SNMPGET" ] || [ ! -x "$SNMPGET" ] ; then
      echo "no (no snmpget executable)"
      exit 0
  fi

  for m in ${UNITS} ; do
    if ping -c1 -q "$m" >/dev/null 2>&1; then continue; fi
    echo "no (can't reach $m)" ; exit 0
  done
  echo "yes" ; exit 0
fi

if [ "$1" = "suggest" ]; then
    echo temperature
    echo humidity
    exit 0
fi

if [ "$1" = "config" ]; then
  echo "graph_title Environmental units (${NAME} probes)"
  echo "graph_vlabel ${LABEL}"
  for m in ${UNITS} ; do
    mm=$(echo "$m" | tr '-' '_')
    echo "${mm}_${LETTER}1.label $m ${NAME} #1"
    echo "${mm}_${LETTER}2.label $m ${NAME} #2"
  done
  exit 0
fi

for m in ${UNITS} ; do
  v1=$(snmp_get "$m" "${TOID}.1")
  v2=$(snmp_get "$m" "${TOID}.2")
  mm=$(echo "$m" | tr '-' '_')
  echo "${mm}_${LETTER}1.value $v1"
  echo "${mm}_${LETTER}2.value $v2"
done