check_iftraffic_OID

Project Notes

Explanation:
Originally writted to monitor Ubiquiti AirFiber backhaul. With this hardware, network interface speed is dependent on weather condition and distance so snmp values are not in classical SNMPv2 branch but in private MIB.

This plugin allow you to check interface speed Tx and Rx by an OID, data counters by an OID, specify unit for datas received (tipically, in my case, RxTx are in bits and data counters in octets). He converts output in unit of your choice (bits, bytes/octets) and at the scale of your choice for graphs (bits/bytes, kilo, mega, giga).

Example:
check_iftraffic_oid.pl -H 172.18.31.126 -C public -v 1 -s .1.3.6.1.4.1.41112.1.3.1.1.14.1 -R .1.3.6.1.4.1.41112.1.3.3.1.66.1 -T .1.3.6.1.4.1.41112.1.3.3.1.64.1 -e B -I .1.3.6.1.4.1.41112.1.3.2.1.5.1 -O .1.3.6.1.4.1.41112.1.3.2.1.6.1 -m b -f M -b -w 95 -c 99

Usage: check_iftraffic_oid.pl -H host [ -C community ] [ -v version] [ -p port] -b [ -n counter_name ] [ -R oid_string ] [ -T oid_string ] [ -e input_unit ] [ -I oid_string ] [ -O oid_string ] [ -m RxTx_unit] [ -f output_scale] [ -w warn ] [ -c crit ]

Check with a MIB explorer if values provided by -I, -O -R and -T are in bits or Bytes to set -e and -m options.

Options:

-H, --host STRING or IPADDRESS
Check interface on the indicated host.
-b, --bits
Display results in bits per second b/s (default: Bytes/s)
-C, --community STRING
SNMP Community.
-v --version STRING
default snmp v1
-p --port INTEGER
snmp port
-n, --counterName STRING
Unique identifier of your choice for this counter. Required if you don't use -s
-s --oidDescr
oid where you can find interface description. Required if you don't use -n.
Overwrite -n option
-R --snmpIfInOctets STRING
oid for RX counter
-T --snmpIfOutOctets STRING
oid for TX counter
-e, --inputUnits STRING
b=bits, B=Bytes
Units of collected datas by -I and -O options. Default, bits
-I, --inBandwidth STRING
SNMP OID in which Rx capacity can be found. Applied to
both IN and OUT if no second (-O) max speed is provided.
-O, --outBandwidth STRING
SNMP OID in which Tx capacity can be found
-m --RxTxUnit
b=bits/s, B=Bytes/s
unit of Rx/Tx capacity (default bits).
-f, --outputScale
G=giga,M=mega,K=kilo,B=stay in bits or Bytes (according to -b option). Default, mega.
Scale of perfdata result (scale of your graph).
-w, --warning INTEGER
% of bandwidth usage necessary to result in warning status (default: 85%)
-c, --critical INTEGER
% of bandwidth usage necessary to result in critical status (default: 98%)