From 175c1a2087fd60526b889f05d97d831f06c01f18 Mon Sep 17 00:00:00 2001
From: Lars Strand <unknown@munin-monitoring.org>
Date: Mon, 20 Nov 2006 13:38:40 +0100
Subject: [PATCH] Initial version

---
 plugins/other/snmp_memory | 174 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 174 insertions(+)
 create mode 100755 plugins/other/snmp_memory

diff --git a/plugins/other/snmp_memory b/plugins/other/snmp_memory
new file mode 100755
index 00000000..b5e16450
--- /dev/null
+++ b/plugins/other/snmp_memory
@@ -0,0 +1,174 @@
+#!/usr/bin/perl -w
+#
+# Copyright (C) 2006 Lars Strand
+#
+# Munin plugin to monitor memory usage by use of SNMP.
+# Based on 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 $host      = $ENV{host}      || undef;
+my $port      = $ENV{port}      || 161;
+my $community = $ENV{community} || "public";
+
+my $response;
+
+if (defined $ARGV[0] and $ARGV[0] eq "snmpconf")
+{
+    print "index   1.3.6.1.2.1.25.5.1.1.2.\n";
+    print "require 1.3.6.1.2.1.25.5.1.1.2. [1-9]\n";
+    print "require 1.3.6.1.2.1.25.2.2.0\n"; # memsize
+    exit 0;
+}
+
+if ($0 =~ /^(?:|.*\/)snmp_([^_]+)_memory$/)
+{
+    $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.";
+}
+
+# memory usage pr. process
+my $hrSWRunPerfMem = "1.3.6.1.2.1.25.5.1.1.2.";
+
+my ($session, $error) = Net::SNMP->session(
+	   -hostname  => $host,
+	   -community => $community,
+	   -port      => $port
+        );
+
+if (!defined ($session))
+{
+    die "Croaking: $error";
+}
+
+# total memory
+my $memsize = &get_single($session, "1.3.6.1.2.1.25.2.2.0") * 1024;
+
+if (defined $ARGV[0] and $ARGV[0] eq "config")
+{
+    print "host_name $host\n";
+    print "graph_title Memory usage\n";
+    print "graph_category system\n";
+    print "graph_vlabel Bytes\n";
+    print "graph_info This grap shows memory usage.\n";
+
+    # some devices reports negative memtotal value
+    print "# Total memsize reported $memsize..." if $DEBUG;
+
+    if ($memsize > 0) 
+    {
+	print "grap_args --base 1024 -l 0 --upper-limit $memsize\n";
+    }
+    else
+    {
+	print "grap_args --base 1024 -l 0\n";
+    }
+
+    print "memory.draw AREA\n";
+    print "memory.label memory\n";
+   
+    exit 0;
+}
+
+my $processes = get_by_regex($session, $hrSWRunPerfMem, "[1-9]");
+
+# the values
+my $memtotal = 0;
+while (my ($pid, $mem) = each(%$processes)) {
+    $memtotal += $mem;
+}
+
+printf "memory.value %d\n", ($memtotal * 1024);
+
+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;
+}