Repository
Munin (contrib)
Last change
2020-04-23
Graph Categories
Family
snmpauto
Capabilities
Keywords
Language
Perl
License
GPL-2.0-only
Authors

snmp__mikrotik

Name

snmp__mikrotik - monitor Mikrotik routers via SNMP

Applicable Systems

Mikrotik Routers

Configuration

As a rule SNMP plugins need site specific configuration. The default configuration (shown here) will only work on insecure sites/devices. [snmp_*] env.version 2 env.community public

Magic Markers

#%# family=snmpauto #%# capabilities=snmpconf

Bugs

None known.

Author

Copyright (C) 2020 Alejandro Suarez (teconecta.es) Based on snmp__if_ plugin.

License

GPLv2.

#!/usr/bin/perl -w

=head1 NAME

snmp__mikrotik - monitor Mikrotik routers via SNMP

=head1 APPLICABLE SYSTEMS

Mikrotik Routers

=head1 CONFIGURATION

As a rule SNMP plugins need site specific configuration.  The default
configuration (shown here) will only work on insecure sites/devices.
   [snmp_*]
        env.version 2
        env.community public

=head1 MAGIC MARKERS

#%# family=snmpauto
#%# capabilities=snmpconf

=head1 BUGS

None known.

=head1 AUTHOR

Copyright (C) 2020 Alejandro Suarez (teconecta.es)
Based on snmp__if_  plugin.

=head1 LICENSE

GPLv2.

=cut

use strict;
use Net::SNMP;

my $DEBUG = 0;

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

my $sysFlashUsageOID = "1.3.6.1.2.1.25.2.3.1.6.131072";
my $sysFlashTotalOID = "1.3.6.1.2.1.25.2.3.1.5.131072";
my $sysRAMUsageOID = "1.3.6.1.2.1.25.2.3.1.6.65536";
my $sysRAMTotalOID = "1.3.6.1.2.1.25.2.3.1.5.65536";
my $sysTempOID = "1.3.6.1.4.1.14988.1.1.3.10.0";

my $response;

if (defined $ARGV[0] and $ARGV[0] eq "snmpconf") {
    print "require $sysFlashUsageOID ^\\d\n";
    print "require $sysFlashTotalOID ^\\d\n";
    print "require $sysRAMUsageOID ^\\d\n";
    print "require $sysRAMTotalOID ^\\d\n";
    exit 0;
}

if ($0 =~ /^(?:|.*\/)snmp_([^_]+)_mikrotik$/) {
    $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
        );


die "Croaking: $error" unless (defined ($session));


if ($ARGV[0] and $ARGV[0] eq "config") {
    print "host_name $host\n";
    $response = $session->get_request($sysFlashTotalOID);
    if (defined $response) {
        print "multigraph flash\n";
        print "graph_args --base 1024 -l 0 --vertical-label Bytes --upper-limit " . ($response->{$sysFlashTotalOID} * 1024) . "\n";
        print "graph_title Flash disk usage\n";
        print "graph_category system\n";
        print "graph_info This graph shows the router's flash disk usage.\n";
        print "graph_order Total Used\n";
        print "graph_vlabel bytes\n";
        print "sysFlashTotal.label Total Memory\n";
        print "sysFlashTotal.draw AREA\n";
        print "sysFlashUsage.label Used Memory\n";
        print "sysFlashUsage.draw AREA\n";
    }

    $response = $session->get_request($sysRAMTotalOID);
    if (defined $response) {
        print "multigraph ram\n";
        print "graph_args --base 1024 -l 0 --vertical-label Bytes --upper-limit " . ($response->{$sysRAMTotalOID} * 1024) . "\n";
        print "graph_title RAM usage\n";
        print "graph_category system\n";
        print "graph_info This graph shows the router's memory usage.\n";
        print "graph_order Total Used\n";
        print "graph_vlabel bytes\n";
        print "sysRAMTotal.label Total Memory\n";
        print "sysRAMTotal.draw AREA\n";
        print "sysRAMUsage.label Used Memory\n";
        print "sysRAMUsage.draw AREA\n";
    }

    $response = $session->get_request($sysTempOID);
    if (defined $response) {
        print "multigraph temp\n";
        print "graph_vlabel degC \n";
        print "graph_title Temperature\n";
        print "graph_category sensors\n";
        print "graph_info This graph shows the router's temperature.\n";
        print "sysTemp.label Temperature\n";
        print "sysTemp.type GAUGE\n";
    }
    exit 0 unless (($ENV{MUNIN_CAP_DIRTYCONFIG} || 0) == 1);
}


print "multigraph flash\n";
$response = $session->get_request(-varbindlist => [$sysFlashUsageOID, $sysFlashTotalOID]);
if (defined $response) {
        print "sysFlashUsage.value ", $response->{$sysFlashUsageOID}*1024, "\n";
        print "sysFlashTotal.value ", $response->{$sysFlashTotalOID}*1024, "\n";
} else {
        print "sysFlashUsage.value U\n";
        print "sysFlashTotal.value U\n";
}

print "multigraph ram\n";
$response = $session->get_request(-varbindlist => [$sysRAMUsageOID, $sysRAMTotalOID]);
if (defined $response) {
        print "sysRAMUsage.value ", $response->{$sysRAMUsageOID}*1024, "\n";
        print "sysRAMTotal.value ", $response->{$sysRAMTotalOID}*1024, "\n";
} else {
        print "sysRAMUsage.value U\n";
        print "sysRAMTotal.value U\n";
}

print "multigraph temp\n";
$response = $session->get_request(-varbindlist => [$sysTempOID]);
if (defined $response) {
        print "sysTemp.value ", $response->{$sysTempOID}/10, "\n";
} else {
        print "sysTemp.value U\n";
}

# vim:syntax=perl