Search All Sites

Search Exchange

Get Monitoring

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com

Login

Remember Me

check_iperf3

Rating
1 vote
Favoured:
0
Current Version
0.1
Last Release Date
2017-04-20
License
GPL
Hits
646
Files:
FileDescription
check_iperf3.plcheck_iperf3.pl
README.txtREADME.txt
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
This is a plugin that monitors the speed between network links using the iperf3 command, which is an active tool for measurements of the maximum achievable bandwidth on IP networks. This script was modified from the original version made by Julien Touche (check_iperf).
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 10 15 ; critical if speed under 10 units
check_iperf3.pl 10 15:50 ; warning if speed out of 15:50 units
check_iperf3.pl 10:100 15:90
check_iperf3.pl 20 35 40M ; UDP test at 40 Mbits/sec
check_iperf3.pl 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
Reviews (1)
byplanet4, April 24, 2017
Hi! Thanks for sharing. I can make this run as root but when using this with check_mk and running as another user I get this error. Any ideas?

Bareword "Types::Serialiser::Error::" refers to nonexistent package at /omd/sites/white/lib/perl5/lib/perl5/Types/Serialiser.pm line 126.