File: //usr/local/ssl/share/munin/plugins/snmp__sensors_fsc_bx_fan
#!/usr/bin/perl -w
# -*- perl -*-
=head1 NAME
snmp__sensors_fsc_bx_fan - Plugin to fetch fan data from the SNMP
agent on the management blade on Fujitsu Simens BX series blade
servers
=head1 LICENSE
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 dated June, 1991.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
=head1 AUTHOR
Copyright (C) 2004 Dagfinn Ilmari Mannsaaker
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
=cut
package Munin::Plugin::SNMP;
use Net::SNMP;
@ISA = qw(Net::SNMP);
sub session {
my $class = shift;
my $host = $ENV{host} || undef;
my $port = $ENV{port} || 161;
my $community = $ENV{community} || 'public';
my $version = $ENV{version} || undef;
if ($0 =~ /^(?:.*\/)?snmp_([^_]+)_/) {
$host = $1;
if ($host =~ /^([^:]+):(\d+)$/) {
$host = $1;
$port = $2;
}
} elsif (!defined($host)) {
return unless wantarray; # Scalar or void context
return (undef, 'Couldn not find monitoring target.'); # Array context
}
return $class->SUPER::session(-hostname => $host,
-community => $community,
-port => $port,
($version ? (-version => $version) : ()));
}
sub get_hash {
my $self = shift;
my %args = @_;
my %ret;
my $base = $args{'-baseoid'};
my $cols = delete $args{'-cols'} or return;
my $table = $self->get_table(%args)
or return;
my $subtabs = join '|', keys %$cols;
my $re = qr/^\Q$base.\E($subtabs)\.(.*)/;
for my $key (keys %$table) {
$key =~ $re;
next unless defined($1 && $2);
$ret{$2}{$cols->{$1}} = $table->{$key};
}
return \%ret;
}
package main;
use strict;
use Net::SNMP qw(oid_lex_sort);
# The OIDs we're after
my $fanBase = '1.3.6.1.4.1.7244.1.1.1.3.3.1.1';
# Subtables
my $fanNumber = 1;
my $fanStatus = 2;
my $fanDesignation = 3;
my $fanCurrentSpeed = 4;
my $fanMaximumSpeed = 5;
# Magic values
my $fanUnknown = 1;
my $fanDisabled = 2;
my $fanUnavailable = 99;
if (defined $ARGV[0] and $ARGV[0] eq 'snmpconf') {
print "index $fanBase.\n";
# Require known, enabled and available fans
print "require $fanBase.$fanStatus. ^[3-9]|[1-8][0-9]|9[0-8]\$\n";
exit 0;
}
my $DEBUG = 0;
my ($session, $error) = Munin::Plugin::SNMP->session();
if ($error) {
die "# Error: $error\n";
}
my $fans = $session->get_hash(-baseoid => $fanBase,
-cols => { $fanNumber => 'number',
$fanStatus => 'status',
$fanCurrentSpeed => 'value',
$fanMaximumSpeed => 'warning',
$fanDesignation => 'label',
},
) or die $session->error();
for my $key (keys %$fans) {
my $fan = $fans->{$key};
# Delete sensors with unknown, disabled or unavailable status
delete $fans->{$key}
if $fan->{status} == $fanUnknown ||
$fan->{status} == $fanDisabled ||
$fan->{status} == $fanUnavailable;
}
if (defined $ARGV[0] and $ARGV[0] eq 'config') {
print <<EOM;
graph_title Fans
graph_args -l 0
graph_vlabel RPM
graph_category sensors
EOM
print 'graph_order ', join(' ', map { get_id($_) } oid_lex_sort keys %$fans), "\n";
print 'host_name ', $session->hostname(), "\n"
unless $session->hostname eq 'localhost';
for my $fan (keys %$fans) {
my $id = get_id($fan);
for my $key (qw(label warning)) {
print "$id.$key $fans->{$fan}{$key}\n";
}
print "$id.type GAUGE\n";
}
} else {
print get_id($_), '.value ', $fans->{$_}{value}, "\n"
for keys %$fans;
}
sub get_id {
(my $id = shift) =~ tr/\./_/;
return 'fan'.$id;
}