- Repository
- Munin (master)
- Last change
- 2018-03-24
- Graph Categories
- 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
#!/bin/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}"
echo "graph_category sensors"
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