plugins/t/check_snmp.t

   1 #! /usr/bin/perl -w -I ..
   2 #
   3 # Simple Network Management Protocol (SNMP) Test via check_snmp
   4 #
   5 #
   6
   7 use strict;
   8 use Test::More;
   9 use NPTest;
  10
  11 BEGIN {
  12     plan skip_all => 'check_snmp is not compiled' unless -x "./check_snmp";
  13     plan tests => 63;
  14 }
  15
  16 my $res;
  17
  18 my $host_snmp          = getTestParameter("NP_HOST_SNMP", "A host providing an SNMP Service", "localhost");
  19 my $snmp_community     = getTestParameter("NP_SNMP_COMMUNITY", "The SNMP Community string for SNMP Testing (assumes snmp v1)", "public");
  20 my $host_nonresponsive = getTestParameter("NP_HOST_NONRESPONSIVE", "The hostname of system not responsive to network requests", "10.0.0.1");
  21 my $hostname_invalid   = getTestParameter("NP_HOSTNAME_INVALID", "An invalid (not known to DNS) hostname", "nosuchhost");
  22 my $user_snmp          = getTestParameter("NP_SNMP_USER", "An SNMP user", "auth_md5");
  23
  24
  25 $res = NPTest->testCmd( "./check_snmp -t 1" );
  26 is( $res->return_code, 3, "No host name" );
  27 is( $res->output, "No host specified" );
  28
  29 $res = NPTest->testCmd( "./check_snmp -H fakehostname --ignore-mib-parsing-errors" );
  30 is( $res->return_code, 3, "No OIDs specified" );
  31 is( $res->output, "No OIDs specified" );
  32
  33 $res = NPTest->testCmd( "./check_snmp -H fakehost --ignore-mib-parsing-errors -o oids -P 3 -U not_a_user --seclevel=rubbish" );
  34 is( $res->return_code, 3, "Invalid seclevel" );
  35 like( $res->output, "/check_snmp: Invalid seclevel - rubbish/" );
  36
  37 $res = NPTest->testCmd( "./check_snmp -H fakehost --ignore-mib-parsing-errors -o oids -P 3c" );
  38 is( $res->return_code, 3, "Invalid protocol" );
  39 like( $res->output, "/check_snmp: Invalid SNMP version - 3c/" );
  40
  41 SKIP: {
  42     skip "no snmp host defined", 50 if ( ! $host_snmp );
  43
  44     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -w 1: -c 1:");
  45     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying uptime" );
  46     like($res->output, '/^SNMP OK - (\d+)/', "String contains SNMP OK");
  47     $res->output =~ /^SNMP OK - (\d+)/;
  48     my $value = $1;
  49     cmp_ok( $value, ">", 0, "Got a time value" );
  50     like($res->perf_output, "/sysUpTime.*$1/", "Got perfdata with value '$1' in it");
  51
  52
  53     # some more threshold tests
  54     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c 1");
  55     cmp_ok( $res->return_code, '==', 2, "Threshold test -c 1" );
  56
  57     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c 1:");
  58     cmp_ok( $res->return_code, '==', 0, "Threshold test -c 1:" );
  59
  60     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c ~:1");
  61     cmp_ok( $res->return_code, '==', 2, "Threshold test -c ~:1" );
  62
  63     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c 1:10");
  64     cmp_ok( $res->return_code, '==', 2, "Threshold test -c 1:10" );
  65
  66     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c \@1:10");
  67     cmp_ok( $res->return_code, '==', 0, "Threshold test -c \@1:10" );
  68
  69     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c 10:1");
  70     cmp_ok( $res->return_code, '==', 0, "Threshold test -c 10:1" );
  71
  72
  73     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o .1.3.6.1.2.1.1.3.0 -w 1: -c 1:");
  74     cmp_ok( $res->return_code, '==', 0, "Test with numeric OID (no mibs loaded)" );
  75     like($res->output, '/^SNMP OK - \d+/', "String contains SNMP OK");
  76
  77     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysDescr.0");
  78     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying sysDescr" );
  79     unlike($res->perf_output, '/sysDescr/', "Perfdata doesn't contain string values");
  80
  81     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysDescr.0,system.sysDescr.0");
  82     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying two string OIDs, comma-separated" );
  83     like($res->output, '/^SNMP OK - /', "String contains SNMP OK");
  84
  85     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysDescr.0 -o system.sysDescr.0");
  86     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying two string OIDs, repeated option" );
  87     like($res->output, '/^SNMP OK - /', "String contains SNMP OK");
  88
  89     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w 1:1 -c 1:1");
  90     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying hrSWRunIndex.1" );
  91     like($res->output, '/^SNMP OK - 1\s.*$/', "String fits SNMP OK and output format");
  92
  93     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w 0   -c 1:");
  94     cmp_ok( $res->return_code, '==', 1, "Exit WARNING when querying hrSWRunIndex.1 and warn-th doesn't apply " );
  95     like($res->output, '/^SNMP WARNING - \*1\*\s.*$/', "String matches SNMP WARNING and output format");
  96
  97     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w  :0 -c 0");
  98     cmp_ok( $res->return_code, '==', 2, "Exit CRITICAL when querying hrSWRunIndex.1 and crit-th doesn't apply" );
  99     like($res->output, '/^SNMP CRITICAL - \*1\*\s.*$/', "String matches SNMP CRITICAL and output format");
 100
 101     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o ifIndex.2,ifIndex.1 -w 1:2 -c 1:2");
 102     cmp_ok( $res->return_code, '==', 0, "Checking two OIDs at once" );
 103     like($res->output, "/^SNMP OK - 2 1/", "Got two values back" );
 104     like( $res->perf_output, "/ifIndex.2=2/", "Got 1st perf data" );
 105     like( $res->perf_output, "/ifIndex.1=1/", "Got 2nd perf data" );
 106
 107     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o ifIndex.2,ifIndex.1 -w 1:2,1:2 -c 2:2,2:2");
 108     cmp_ok( $res->return_code, '==', 2, "Checking critical threshold is passed if any one value crosses" );
 109     like($res->output, "/^SNMP CRITICAL - 2 *1*/", "Got two values back" );
 110     like( $res->perf_output, "/ifIndex.2=2/", "Got 1st perf data" );
 111     like( $res->perf_output, "/ifIndex.1=1/", "Got 2nd perf data" );
 112
 113     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrStorage.hrMemorySize.0,host.hrSystem.hrSystemProcesses.0 -w 1:,1: -c 1:,1:");
 114     cmp_ok( $res->return_code, '==', 0, "Exit OK when querying hrMemorySize and hrSystemProcesses");
 115     like($res->output, '/^SNMP OK - \d+ \d+/', "String contains hrMemorySize and hrSystemProcesses");
 116
 117     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w \@:0 -c \@0");
 118     cmp_ok( $res->return_code, '==', 0, "Exit OK with inside-range thresholds");
 119     like($res->output, '/^SNMP OK - 1\s.*$/', "String matches SNMP OK and output format");
 120
 121     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o enterprises.ucdavis.laTable.laEntry.laLoad.3");
 122     $res->output =~ m/^SNMP OK - (\d+\.\d{2})\s.*$/;
 123     my $lower = $1 - 0.05;
 124     my $higher = $1 + 0.05;
 125     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o enterprises.ucdavis.laTable.laEntry.laLoad.3 -w $lower -c $higher");
 126     cmp_ok( $res->return_code, '==', 1, "Exit WARNING with fractionnal arguments");
 127
 128     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0,host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w ,:0 -c ,:2");
 129     cmp_ok( $res->return_code, '==', 1, "Exit WARNING on 2nd threshold");
 130     like($res->output, '/^SNMP WARNING - Timeticks:\s\(\d+\)\s+(?:\d+ days?,\s+)?\d+:\d+:\d+\.\d+\s+\*1\*\s.*$/', "First OID returned as string, 2nd checked for thresholds");
 131
 132     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrSWRun.hrSWRunTable.hrSWRunEntry.hrSWRunIndex.1 -w '' -c ''");
 133     cmp_ok( $res->return_code, '==', 0, "Empty thresholds doesn't crash");
 134
 135     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrStorage.hrMemorySize.0,host.hrSystem.hrSystemProcesses.0 -w ,,1 -c ,,2");
 136     cmp_ok( $res->return_code, '==', 0, "Skipping first two thresholds on 2 OID check");
 137     like($res->output, '/^SNMP OK - \d+ \w+ \d+\s.*$/', "Skipping first two thresholds, result printed rather than parsed");
 138
 139     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o host.hrStorage.hrMemorySize.0,host.hrSystem.hrSystemProcesses.0 -w ,, -c ,,");
 140     cmp_ok( $res->return_code, '==', 0, "Skipping all thresholds");
 141     like($res->output, '/^SNMP OK - \d+ \w+ \d+\s.*$/', "Skipping all thresholds, result printed rather than parsed");
 142
 143     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0 -c 1000000000000: -u '1/100 sec'");
 144     cmp_ok( $res->return_code, '==', 2, "Timetick used as a threshold");
 145     like($res->output, '/^SNMP CRITICAL - \*\d+\* 1\/100 sec.*$/', "Timetick used as a threshold, parsed as numeric");
 146
 147     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o system.sysUpTime.0");
 148     cmp_ok( $res->return_code, '==', 0, "Timetick used as a string");
 149     like($res->output, '/^SNMP OK - Timeticks:\s\(\d+\)\s+(?:\d+ days?,\s+)?\d+:\d+:\d+\.\d+\s.*$/', "Timetick used as a string, result printed rather than parsed");
 150
 151     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -C $snmp_community -o HOST-RESOURCES-MIB::hrSWRunName.1");
 152     cmp_ok( $res->return_code, '==', 0, "snmp response without datatype");
 153     like( $res->output, '/^SNMP OK - "(systemd|init)" \| $/', "snmp response without datatype" );
 154 }
 155
 156 SKIP: {
 157     skip "no SNMP user defined", 1 if ( ! $user_snmp );
 158     $res = NPTest->testCmd( "./check_snmp -H $host_snmp --ignore-mib-parsing-errors -o HOST-RESOURCES-MIB::hrSystemUptime.0 -P 3 -U $user_snmp -L noAuthNoPriv");
 159     like( $res->output, '/^SNMP OK - Timeticks:\s\(\d+\)\s+(?:\d+ days?,\s+)?\d+:\d+:\d+\.\d+\s.*$/', "noAuthNoPriv security level works properly" );
 160 }
 161
 162 # These checks need a complete command line. An invalid community is used so
 163 # the tests can run on hosts w/o snmp host/community in NPTest.cache. Execution will fail anyway
 164 SKIP: {
 165     skip "no non responsive host defined", 2 if ( ! $host_nonresponsive );
 166     $res = NPTest->testCmd( "./check_snmp -H $host_nonresponsive --ignore-mib-parsing-errors -C np_foobar -o system.sysUpTime.0 -w 1: -c 1:");
 167     cmp_ok( $res->return_code, '==', 2, "Exit CRITICAL with non responsive host" );
 168     like($res->output, '/Plugin timed out while executing system call/', "String matches timeout problem");
 169 }
 170
 171 SKIP: {
 172     skip "no non invalid host defined", 2 if ( ! $hostname_invalid );
 173     $res = NPTest->testCmd( "./check_snmp -H $hostname_invalid --ignore-mib-parsing-errors -C np_foobar -o system.sysUpTime.0 -w 1: -c 1:");
 174     cmp_ok( $res->return_code, '==', 3, "Exit UNKNOWN with non responsive host" );
 175     like($res->output, '/External command error: .*(nosuchhost|Name or service not known|Unknown host).*/s', "String matches invalid host");
 176 }