Mirrors/Munin-Contrib
1
0
Fork 0
mirror of https://github.com/munin-monitoring/contrib.git synced 2025-07-22 02:51:03 +00:00
Code Issues Releases Wiki Activity

overhaul of snmp__ups_ plugin.

Browse source 
Changes:
- More queries supported (inputpower, batterycurrent, batteryruntime (how long
  have we been running on battery), batterypercent (percent remaining),
  inputlinebads (how often was input bad))
- fix a few wrong units (e.g. current is measured in amp, not in watt)
- some UPSes violate RFC 1628 by not returning the number of input-/
  output-lines they have. In this case assume 3 lines instead of 0
  (and just printing nothing at all).
- Make mode parameters all lowercase instead of camelcase - camelcase
  just looks retarded in the plugin-symlink-names.
- some more smaller fixes
This commit is contained in:
Michael 'PoempelFox' Meier 2015-02-13 16:58:26 +01:00
parent 323b4a7937
commit 7a306e6223
1 changed files with 149 additions and 100 deletions
Download patch file Download diff file Expand all files Collapse all files

183
plugins/snmp/snmp__ups_
View file

@ -1,7 +1,11 @@
#!/usr/bin/perl -w #!/usr/bin/perl -w
# #
# Jean-Samuel Reynaud <js.reynaud@free.fr> # This plugin is for querying UPSes that support the UPS-MIB from RFC 1628
# base on snmp__if_ from Jimmy Olsen, Dagfinn Ilmari Mannsaaker # - NOT APC (apparently)
#
# current version by Michael Meier <michael.meier@fau.de>
# previous version by Jean-Samuel Reynaud <js.reynaud@free.fr>
# based on snmp__if_ from Jimmy Olsen, Dagfinn Ilmari Mannsaaker
# #
# This program is free software; you can redistribute it and/or # This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License # modify it under the terms of the GNU General Public License
@ -19,17 +23,19 @@
# #
# #
# Usage: # Usage:
# ln -s /usr/share/munin/node/plugins-auto/snmp__ups2_ /etc/munin/node.d/snmp_ups.address.loc_mode # ln -s /usr/share/munin/node/plugins-auto/snmp__ups_ /etc/munin/node.d/snmp_ups.domain.tld_ups_mode
# with mode : batteryVoltage, batteryTemperature,inputVoltage,inputCurrent,inputFrequency,outputVoltage,outputCurrent,outputPower,outputPercentLoad,ChargeRemaining # available modes:
# batteryruntime, batteryremaining, batterypercent, batteryvoltage,
# batterycurrent, batterytemperature,
# inputfrequency, inputvoltage, inputcurrent, inputpower,
# outputvoltage, outputcurrent, outputpower, outputpercentload,
# inputlinebads
# Most UPSs only support a small subset of these modes.
# #
#%# family=snmpauto #%# family=snmpauto
#%# capabilities=snmpconf #%# capabilities=snmpconf
# This plugin is for UPSes that supports the UPS-MIB
# - Not APC (apparently)
use strict; use strict;
use Net::SNMP; use Net::SNMP;
@ -48,110 +54,148 @@ if (defined $ARGV[0] and $ARGV[0] eq "snmpconf")
exit 0; exit 0;
} }
if ($0 =~ /^(?:|.*\/)snmp_([^_]+)_ups_(.+)$/) if ($0 =~ /^(?:|.*\/)snmp_([^_]+)_ups_(.+)$/)
{ {
$host = $1; $host = $1;
$mode = $2; $mode = $2;
if ($host =~ /^([^:]+):(\d+)$/) if ($host =~ /^([^:]+):(\d+)$/) {
{
$host = $1; $host = $1;
$port = $2; $port = $2;
} }
} }
elsif (!defined($host)) elsif (!defined($host))
{ {
print "# Debug: $0 -- $1 -- $2\n" if $DEBUG; print("# Debug: $0 -- $1 -- $2\n") if $DEBUG;
die "# Error: couldn't understand what I'm supposed to monitor."; print("# Error: couldn't understand what I'm supposed to monitor.\n");
print("# You need to either name this plugin properly in the scheme\n");
print("# snmp_HOSTNAME_ups_MODE\n");
print("# or alternatively set the environment variables 'host' and 'mode'\n");
exit(1);
} }
my $graphs = { my $graphs = {
'batteryVoltage' => { 'title' => 'Battery Voltage', 'batteryruntime' => { 'title' => 'Seconds running on battery',
'category' => 'network', 'unit' => 'seconds',
'label' => 'onbatteryfor',
'value' => '.1.3.6.1.2.1.33.1.2.2' },
'batteryremaining' => { 'title' => 'Estimated remaining runtime on battery',
'unit' => 'minutes',
'label' => 'remaining',
'value' => '.1.3.6.1.2.1.33.1.2.3' },
'batterypercent' => { 'title' => 'Estimated remaining charge',
'unit' => '%',
'label' => 'remaining',
'value' => '.1.3.6.1.2.1.33.1.2.4' },
'batteryvoltage' => { 'title' => 'Battery Voltage',
'unit' => 'Volt', 'unit' => 'Volt',
'scale' => 0.1,
'value' => '.1.3.6.1.2.1.33.1.2.5' }, 'value' => '.1.3.6.1.2.1.33.1.2.5' },
'batteryTemperature' => { 'title' => 'Battery Temperature', 'batterycurrent' => { 'title' => 'Battery current',
'category' => 'network', 'unit' => 'Ampere',
'unit' => 'DegC', 'scale' => 0.1,
'value' => '.1.3.6.1.2.1.33.1.2.6' },
'batterytemperature' => { 'title' => 'Battery Temperature',
'unit' => 'degC',
'label' => 'Temperature %u',
'value' => '.1.3.6.1.2.1.33.1.2.7' }, 'value' => '.1.3.6.1.2.1.33.1.2.7' },
'inputVoltage' => { 'title' => 'Input Voltage', 'inputfrequency' => { 'title' => 'Input Frequency',
'category' => 'network', 'scale' => 0.1,
'unit' => 'Hz',
'list' => '.1.3.6.1.2.1.33.1.3.2',
'value' => '.1.3.6.1.2.1.33.1.3.3.1.2' },
'inputvoltage' => { 'title' => 'Input Voltage',
'unit' => 'Volt', 'unit' => 'Volt',
'list' => '.1.3.6.1.2.1.33.1.3.2', 'list' => '.1.3.6.1.2.1.33.1.3.2',
'value' => '.1.3.6.1.2.1.33.1.3.3.1.3' }, 'value' => '.1.3.6.1.2.1.33.1.3.3.1.3' },
'inputCurrent' => { 'title' => 'Input Current', 'inputcurrent' => { 'title' => 'Input Current',
'category' => 'network', 'unit' => 'Ampere',
'unit' => 'Watt', 'scale' => 0.1,
'list' => '.1.3.6.1.2.1.33.1.3.2', 'list' => '.1.3.6.1.2.1.33.1.3.2',
'value' => '.1.3.6.1.2.1.33.1.3.3.1.4' }, 'value' => '.1.3.6.1.2.1.33.1.3.3.1.4' },
'inputFrequency' => { 'title' => 'Input Frequency', 'inputpower' => { 'title' => 'Input Power',
'category' => 'network', 'unit' => 'Watt',
'list' => '.1.3.6.1.2.1.33.1.3.2', 'list' => '.1.3.6.1.2.1.33.1.3.2',
'unit' => 'Hz', 'value' => '.1.3.6.1.2.1.33.1.3.3.1.5' },
'value' => '.1.3.6.1.2.1.33.1.3.3.1.2'}, 'outputvoltage' => { 'title' => 'Output Voltage',
'outputVoltage' => { 'title' => 'Output Voltage',
'category' => 'network',
'list' => '.1.3.6.1.2.1.33.1.4.3', 'list' => '.1.3.6.1.2.1.33.1.4.3',
'unit' => 'Hz', 'unit' => 'Volt',
'value' => '.1.3.6.1.2.1.33.1.4.4.1.2' }, 'value' => '.1.3.6.1.2.1.33.1.4.4.1.2' },
'outputCurrent' => { 'title' => 'Output Current', 'outputcurrent' => { 'title' => 'Output Current',
'category' => 'network', 'unit' => 'Ampere',
'scale' => 0.1,
'list' => '.1.3.6.1.2.1.33.1.4.3', 'list' => '.1.3.6.1.2.1.33.1.4.3',
'value' => '.1.3.6.1.2.1.33.1.4.4.1.3' }, 'value' => '.1.3.6.1.2.1.33.1.4.4.1.3' },
'outputPower' => { 'title' => 'Output Power', 'outputpower' => { 'title' => 'Output Power',
'category' => 'network', 'unit' => 'Watt',
'list' => '.1.3.6.1.2.1.33.1.4.3', 'list' => '.1.3.6.1.2.1.33.1.4.3',
'unit' => 'Hz',
'value' => '.1.3.6.1.2.1.33.1.4.4.1.4' }, 'value' => '.1.3.6.1.2.1.33.1.4.4.1.4' },
'outputpercentload' => { 'title' => 'Output Load',
'outputPercentLoad' => { 'title' => 'Output PercentLoad',
'category' => 'network',
'list' => '.1.3.6.1.2.1.33.1.4.3',
'unit' => '%', 'unit' => '%',
'list' => '.1.3.6.1.2.1.33.1.4.3',
'value' => '.1.3.6.1.2.1.33.1.4.4.1.5' }, 'value' => '.1.3.6.1.2.1.33.1.4.4.1.5' },
'inputlinebads' => { 'title' => 'Number of times input power went bad',
'ChargeRemaining' => { 'title' => 'Charge remaining', 'unit' => 'n',
'unit' => 'Seconds', 'value' => '.1.3.6.1.2.1.33.1.3.1' }
'category' => 'network',
'value' => '.1.3.6.1.2.1.33.1.2.4'}
}; };
my ($session, $error) = Net::SNMP->session( my ($session, $error) = Net::SNMP->session(
-hostname => $host, -hostname => $host,
-community => $community, -community => $community,
-port => $port -port => $port,
-timeout => 1.0
); );
if (!defined ($session)) if (!defined($session)) {
{ print("# Failed to open SNMP session: $error\n");
die "Croaking: $error"; exit(1);
}
unless (defined($graphs->{$mode}->{'title'})) {
print("# Unknown mode '$mode'! Available modes are:\n");
foreach my $m (keys(%{$graphs})) {
if (defined($graphs->{$m}->{'title'})) {
printf("# %-18s %s\n", $m, $graphs->{$m}->{'title'});
}
}
exit(1);
} }
my $count_data = 1; my $count_data = 1;
if (defined $graphs->{$mode}->{'list'} && if (defined $graphs->{$mode}->{'list'}) {
defined ($response = $session->get_request($graphs->{$mode}->{'list'} . ".0"))) { if (defined ($response = $session->get_request($graphs->{$mode}->{'list'} . ".0"))) {
$count_data = $response->{$graphs->{$mode}->{'list'} . ".0"}; $count_data = $response->{$graphs->{$mode}->{'list'} . ".0"};
} else { # Unfortunately, some UPSs do not properly implement RFC 1628:
# They fail to report the number of lines.
# We will default to 3 as that will work in most cases.
# The environment variable 'numlines' can be used to override the default.
$count_data = 3;
if (defined($ENV{'numlines'})) {
$count_data = int($ENV{'numlines'});
}
}
} }
if ($ARGV[0] and $ARGV[0] eq "config") if ($ARGV[0] and $ARGV[0] eq "config") {
{ print("host_name $host\n");
print "host_name $host\n"; printf("graph_title %s\n", $graphs->{$mode}->{'title'});
printf "graph_title %s \n",$graphs->{$mode}->{'title'};
# print "graph_args --base 1000\n"; # print "graph_args --base 1000\n";
print "graph_category sensors\n"; print("graph_category sensors\n");
printf("graph_vlabel %s\n", $graphs->{$mode}->{'unit'});
for (my $i=0; $i < $count_data; $i++) { for (my $i=0; $i < $count_data; $i++) {
printf "line%u.label Line %u\n",$i+1,$i+1; my $ip1 = $i + 1;
printf "line%u.type GAUGE\n",$i+1; if (defined($graphs->{$mode}->{'label'})) {
printf "line%u.info %s\n",$i+1,$graphs->{$mode}->{'unit'}; printf("%s%u.label %s\n", $mode, $ip1, sprintf($graphs->{$mode}->{'label'}, $ip1));
} else {
printf("%s%u.label Line %u\n", $mode, $ip1, $ip1);
} }
exit 0; printf("%s%u.type GAUGE\n", $mode, $ip1);
#printf "line%u.info %s\n",$i+1,$graphs->{$mode}->{'unit'};
if (defined($ENV{"${mode}${ip1}.warning"})) { printf("%s%s.warning %s\n", $mode, $ip1, $ENV{"${mode}${ip1}.warning"}); }
if (defined($ENV{"${mode}${ip1}.critical"})) { printf("%s%s.critical %s\n", $mode, $ip1, $ENV{"${mode}${ip1}.critical"}); }
}
exit(0);
} }
for (my $i = 0; $i < $count_data; $i++) { for (my $i = 0; $i < $count_data; $i++) {
@ -160,9 +204,14 @@ for(my $i=0;$i<$count_data;$i++) {
$l_current = 0; $l_current = 0;
} }
if (defined ($response = $session->get_request($graphs->{$mode}->{'value'} . sprintf(".%u",$l_current)))) { if (defined ($response = $session->get_request($graphs->{$mode}->{'value'} . sprintf(".%u",$l_current)))) {
printf "line%u.value %u\n",$i+1,$response->{$graphs->{$mode}->{'value'} . sprintf(".%u",$l_current)}; my $v = $response->{$graphs->{$mode}->{'value'} . sprintf(".%u",$l_current)};
if (defined($graphs->{$mode}->{'scale'})) {
$v = $v * $graphs->{$mode}->{'scale'};
printf("%s%u.value %.1f\n", $mode, $i+1, $v);
} else { } else {
printf "line%u.value U\n",$i+1; printf("%s%u.value %u\n", $mode, $i+1, $v);
}
} else {
printf("%s%u.value U\n", $mode, $i+1);
} }
} }