Search Exchange

Search All Sites

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

Directory Tree

check_iperf3

Rating
1 vote
Favoured:
0
Current Version
0.1
Last Release Date
2017-04-20
License
GPL
Hits
10645
Files:
FileDescription
check_iperf3.plcheck_iperf3.pl
README.txtREADME.txt
Nagios CSP

Meet The New Nagios Core Services Platform

Built on over 25 years of monitoring experience, the Nagios Core Services Platform provides insightful monitoring dashboards, time-saving monitoring wizards, and unmatched ease of use. Use it for free indefinitely.

Monitoring Made Magically Better

  • Nagios Core on Overdrive
  • Powerful Monitoring Dashboards
  • Time-Saving Configuration Wizards
  • Open Source Powered Monitoring On Steroids
  • And So Much More!
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.