/usr/share/munin/plugins/nomadix_users_ is in munin-plugins-extra 2.0.25-2.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | #!/usr/bin/perl
=pod
=encoding UTF-8
=head1 NAME
nomadix_users_ - SNMP wildcard plugin to monitor the number of users of Nomadix Enterprise WiFi devices
=head1 APPLICABLE SYSTEMS
The plugin was written specifically for OSL's nomadix equipment. It
uses SNMP to monitor the devices. Any devices that support one or
more of these OIDs:
.1.3.6.1.4.1.3309.1.1.2.18.1.1.8 from USG-II
.1.3.6.1.4.1.3309.1.4.2.18.1.1.8 for AG5000
.1.3.6.1.4.1.3309.1.5.2.18.1.1.8 for AG3000
should be able to get their users counted.
=head1 CONFIGURATION
Configuration is done by editing the plugin.
=head1 BUGS
Should support configuration via the environment
Should be rewritten as a autoconfigurable snmp__users (or some such
name, not sure how specific the OIDs it presents are) plugin using the
Plugin::SNMP module.
=head1 AUTHOR
(C) Copyright 2006-2009. Written by Espen Braastad, Linpro AS for OSL
(2006) Further modified by Erik Inge Bolsø, Linpro AS for OSL (2007)
=head1 LICENSE
GPLv2.
=head1 MAGIC MARKERS
None. No autoconfiguration is supported and indeed the plugin must be
configured by editing it.
=cut
use strict;
use Net::SNMP;
my $snmpwalk="/usr/bin/snmpwalk"; # Path to the snmpwalk executable
my $timeout=1; # snmp timeout
my $debug=0; # Enable/disable debugging
my $community="public";
my $oid_users=".1.3.6.1.4.1.3309.1.1.2.18.1.1.8"; #USG-II
my $oid_users_2=".1.3.6.1.4.1.3309.1.4.2.18.1.1.8"; #AG5000
my $oid_users_3=".1.3.6.1.4.1.3309.1.5.2.18.1.1.8"; #AG3000
my $oid_name=".1.3.6.1.2.1.1.5.0";
my $target=`basename $0 | sed 's/^nomadix_users_//g'`;
exit 2 unless defined $target;
$target=~s/\_/\./g;
chomp($target);
my $status=2;
if ($ARGV[0] and $ARGV[0] eq "autoconf")
{
if(-x ${snmpwalk}){
my ${test}=`${snmpwalk} -v 1 -c ${community} -t ${timeout} ${target} ${oid_users} -Cp -OQv 2>/dev/null`;
if($?==0){
print "yes\n";
exit 0;
}
exit 1;
}
exit 1;
}
if($ARGV[0] and $ARGV[0] eq "config") {
my ${sysname}=`${snmpwalk} -v 1 -c ${community} -t ${timeout} ${target} ${oid_name} -OQv 2>/dev/null`;
chomp(${sysname});
print "graph_title Users on " . ${sysname} . " (" . ${target} . ")\n";
print "graph_args --base 1000\n";
print "graph_vlabel Active users\n";
print "graph_category Nomadix\n";
print 'graph_info This graph shows the amount of users in AAA state "Valid" connected to ' . ${target} . ".\n";
print "valid.label Valid users\n";
print "valid.type GAUGE\n";
exit 0;
}
# Checking if snmpwalk is found and executable
if(! -x ${snmpwalk}){
${status}=2;
print STDERR "Error: " . ${snmpwalk} . " not found.\n";
if(${debug}){
print "Exit code: " . ${status} . "\n";
}
exit ${status};
}
# Let's see if we are able to talk to the SNMP host
my @{users}=split("\n",`${snmpwalk} -v 1 -c ${community} -t ${timeout} ${target} ${oid_users} -Cp -OQv 2>/dev/null`);
my ${snmpexit}=$?;
if(${snmpexit}!=0){
${status}=2;
print STDERR "Error: Unable to connect to ${target}. Exit code was " . ${snmpexit} . ".\n";
if(${debug}){
print "Exit code: " . ${status} . "\n";
}
exit ${status};
}
# Count users, both valid and otherwise
my ${number_of_users}=(split(" ",${users[-1]}))[-1];
if (${number_of_users} == 0)
{
@{users}=split("\n",`${snmpwalk} -v 1 -c ${community} -t ${timeout} ${target} ${oid_users_2} -Cp -OQv 2>/dev/null`);
}
${number_of_users}=(split(" ",${users[-1]}))[-1];
if (${number_of_users} == 0)
{
@{users}=split("\n",`${snmpwalk} -v 1 -c ${community} -t ${timeout} ${target} ${oid_users_3} -Cp -OQv 2>/dev/null`);
}
${number_of_users}=(split(" ",${users[-1]}))[-1];
if(${debug}){
print "Total number of users found: " . ${number_of_users} . "\n";
}
# Checking if the number of users is a numeric value
if (${number_of_users} =~ /^-?\d/){
# Loop through users, extract authentication state
my ${valid_users}=0;
for(my ${i}=1 ; ${i}<=${number_of_users} ; ${i}++){
my ${state}=${users[${i}-1]};
if(${state} =~ /Valid/){
${valid_users}+=1;
}
if(${debug}){
print "User in state " . ${state} . "\n";
}
}
# Write human readable output
print "valid.value " . ${valid_users} . "\n";
if(${debug}){
print "Exit code: " . ${status} . "\n";
}
${status}=0;
exit ${status};
} else {
${status}=2;
print STDERR "Error: The number of users found is not a numerical value. Unable to monitor correctly.\n";
if(${debug}){
print "Exit code: " . ${status} . "\n";
}
exit ${status};
}
# Obs!
print STDERR "This is not supposed to happen. Debugging is needed!\n";
${status}=2;
if(${debug}){
print "Exit code: " . ${status} . "\n";
}
exit ${status};
|