1#! /usr/bin/perl -w -I .. 2# 3# Simple Network Management Protocol (SNMP) Test via check_snmp 4# 5# 6 7use strict; 8use Test::More; 9use NPTest; 10 11BEGIN { 12 plan skip_all => 'check_snmp is not compiled' unless -x "./check_snmp"; 13 plan tests => 63; 14} 15 16my $res; 17 18my $host_snmp = getTestParameter("NP_HOST_SNMP", "A host providing an SNMP Service", "localhost"); 19my $snmp_community = getTestParameter("NP_SNMP_COMMUNITY", "The SNMP Community string for SNMP Testing (assumes snmp v1)", "public"); 20my $host_nonresponsive = getTestParameter("NP_HOST_NONRESPONSIVE", "The hostname of system not responsive to network requests", "10.0.0.1"); 21my $hostname_invalid = getTestParameter("NP_HOSTNAME_INVALID", "An invalid (not known to DNS) hostname", "nosuchhost"); 22my $user_snmp = getTestParameter("NP_SNMP_USER", "An SNMP user", "auth_md5"); 23 24 25$res = NPTest->testCmd( "./check_snmp -t 1" ); 26is( $res->return_code, 3, "No host name" ); 27is( $res->output, "No host specified" ); 28 29$res = NPTest->testCmd( "./check_snmp -H fakehostname" ); 30is( $res->return_code, 3, "No OIDs specified" ); 31is( $res->output, "No OIDs specified" ); 32 33$res = NPTest->testCmd( "./check_snmp -H fakehost -o oids -P 3 -U not_a_user --seclevel=rubbish" ); 34is( $res->return_code, 3, "Invalid seclevel" ); 35like( $res->output, "/check_snmp: Invalid seclevel - rubbish/" ); 36 37$res = NPTest->testCmd( "./check_snmp -H fakehost -o oids -P 3c" ); 38is( $res->return_code, 3, "Invalid protocol" ); 39like( $res->output, "/check_snmp: Invalid SNMP version - 3c/" ); 40 41SKIP: { 42 skip "no snmp host defined", 50 if ( ! $host_snmp ); 43 44 $res = NPTest->testCmd( "./check_snmp -H $host_snmp -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 156SKIP: { 157 skip "no SNMP user defined", 1 if ( ! $user_snmp ); 158 $res = NPTest->testCmd( "./check_snmp -H $host_snmp -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 164SKIP: { 165 skip "no non responsive host defined", 2 if ( ! $host_nonresponsive ); 166 $res = NPTest->testCmd( "./check_snmp -H $host_nonresponsive -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 171SKIP: { 172 skip "no non invalid host defined", 2 if ( ! $hostname_invalid ); 173 $res = NPTest->testCmd( "./check_snmp -H $hostname_invalid -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)/', "String matches invalid host"); 176} 177