check_iperf3

Project Notes

check_iperf3.pl allows you to test both, TCP and UDP protocols.
PERFORMANCE DATA is returned back to Nagios.

see README for more details (setup).

TCP usage (tell me the max bandwidth available):
------------------------------------------------
$ check_iperf3.pl Target_host Crit Warn

Where:
Target_host Target host
Crit Critical speed unit, range allowed in the form x:y
Warn Warning speed unit, range allowed in the form x:y

UDP usage (test at an specific bandwidth target):
-------------------------------------------------
$ check_iperf3.pl target_host Crit Warn Bandwidth

Where:
target_host Target host
Crit Critical speed unit, range allowed in the form x:y
Warn Warning speed unit, range allowed in the form x:y
Bandwidth target_bandwidth[KMG] (test is made in bits/sec)

examples:
check_iperf3.pl <host> 10 15 ; critical if speed under 10 units
check_iperf3.pl <host> 10 15:50 ; warning if speed out of 15:50 units
check_iperf3.pl <host> 10:100 15:90
check_iperf3.pl <host> 20 35 40M ; UDP test at 40 Mbits/sec
check_iperf3.pl <host> 20 35 1G ; UDP test at 1 Gbit/sec

Sample output:
$ check_iperf3.pl 10.0.1.10 5 10
OK: iperf returns 11.01MB |Bandwidth=11.01MB
INFO:
************************************************************
Iperf Version : iperf 3.0.11
Remote Host:Port : 10.0.1.10:5201
Protocol : TCP
TCP MTU : 1340
Streams : 1
Test duration (sec) : 30
Speed (bytes/sec) : 11.01 MB/sec
Speed (bits/sec) : 88.11 Mb/sec
Block Size : 131072
Bytes transmitted : 330415860
************************************************************
DEBUG CMD: $ /usr/bin/iperf3 -J -c 10.0.1.10 -t 30