contrib-munin/plugins/disk/snmp__swap

#!/usr/bin/perl -w
#
# Copyright (C) 2006 Lars Strand
#
# Munin plugin to monitor swap usage by use of SNMP.
# Based on the snmp__df plugin
#
# 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
#
# $Log$
#
#%# family=snmpauto
#%# capabilities=snmpconf

use strict;
use Net::SNMP;

my $DEBUG = 0;
my $MAXLABEL = 20;

my $host      = $ENV{host}      || undef;
my $port      = $ENV{port}      || 161;
my $community = $ENV{community} || "public";
my $iface     = $ENV{interface} || undef;

my $response;

if (defined $ARGV[0] and $ARGV[0] eq "snmpconf")
{
    # HOST-RESOURCES-MIB::hrStorage
    # HOST-RESOURCES-TYPES::hrStorageVirtualMemory
    print "require 1.3.6.1.2.1.25.2. 1.3.6.1.2.1.25.2.1.3\n"; 
    exit 0;
}

if ($0 =~ /^(?:|.*\/)snmp_([^_]+)_swap$/)
{
    $host  = $1;
    if ($host =~ /^([^:]+):(\d+)$/)
    {
	$host = $1;
	$port = $2;
    }
}
elsif (!defined($host))
{
    print "# Debug: $0 -- $1\n" if $DEBUG;
    die "# Error: couldn't understand what I'm supposed to monitor.";
}

my ($session, $error) = Net::SNMP->session(
     -hostname  => $host,
     -community => $community,
     -port      => $port
    );

if (!defined ($session))
{
    die "Croaking: $error";
}

my $hrStorage = "1.3.6.1.2.1.25.2.";
my $hrStorageVirtualMemory = "1.3.6.1.2.1.25.2.1.3";
my $hrStorageSize = "1.3.6.1.2.1.25.2.3.1.5.";
my $hrStorageUsed = "1.3.6.1.2.1.25.2.3.1.6.";

my $swap_d = get_by_regex($session, $hrStorage, $hrStorageVirtualMemory);

my $swapsize = 0; my $swapused = 0;

foreach my $swap (keys %$swap_d) 
{
    $swapsize += get_single($session, $hrStorageSize . $swap);
    $swapused += get_single($session, $hrStorageUsed . $swap);
}

if (defined $ARGV[0] and $ARGV[0] eq "config")
{
    print "host_name $host\n";
    print "graph_title Virtual memory usage\n";
    if ($swapsize > 0) 
    {
	print "graph_args -l 0 --base 1000 --upper-limit $swapsize\n";
    } 
    else 
    {
	print "graph_args -l 0 --base 1000\n";
    }
    print "graph_vlabel Bytes\n";
    print "graph_category disk\n";
    print "graph_info This graph shows swap usage in bytes.\n";
    print "swap.label swap\n";
    print "swap.type DERIVE\n";
    print "swap.min 0\n";
    exit 0;
}

print "swap.value $swapused\n";

sub get_single
{
    my $handle = shift;
    my $oid    = shift;
    
    print "# Getting single $oid..." if $DEBUG;
    
    $response = $handle->get_request ($oid);
    
    if (!defined $response->{$oid})
    {
	print "undef\n" if $DEBUG;
	return undef;
    }
    else
    {
	print "\"$response->{$oid}\"\n" if $DEBUG;
	return $response->{$oid};
    }
}

sub get_by_regex
{
    my $handle = shift;
    my $oid    = shift;
    my $regex  = shift;
    my $result = {};
    my $num    = 0;
    my $ret    = $oid . "0";
    my $response;
    
    print "# Starting browse of $oid...\n" if $DEBUG;
    
    while (1)
    {
	if ($num == 0)
	{
	    print "# Checking for $ret...\n" if $DEBUG;
	    $response = $handle->get_request ($ret);
	}
	if ($num or !defined $response)
	{
	    print "# Checking for sibling of $ret...\n" if $DEBUG;
	    $response = $handle->get_next_request ($ret);
	}
	if (!$response)
	{
	    return undef;
	}
	my @keys = keys %$response;
	$ret = $keys[0];
	print "# Analyzing $ret (compared to $oid)...\n" if $DEBUG;
	last unless ($ret =~ /^$oid/);
	$num++;
	next unless ($response->{$ret} =~ /$regex/);
	@keys = split (/\./, $ret);
	$result->{$keys[-1]} = $response->{$ret};;
	print "# Index $num: ", $keys[-1], " (", $response->{$ret}, ")\n" if $DEBUG;
    };
    return $result;
}