Network Connections, Stats and Bandwidth

check_iftraffic5.pl

Write a Review

Description:

Supports all Cisco standard interfaces: TenGigabitEthernet, GigabitEthernet, FastEthernet,
Ethernet, Port-channel, Vlan. Also works on standard NIC adaptors.
Checks input/output traffic, unicast pkts, multicast pkts, broadcast pkts, errors and discards on a single interface.
Checks Port-channel member status. Performance data formatting meets Nagios standards.

Current Version

5

Last Release Date

2012-11-13

Compatible With

  • Nagios 3.x

Owner

Mike Pagano

License

GPL

Copy Page Link Recommend Login to Add to Favorites Login to Claim
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.

Download Now

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!
Project Files
FileDescription
check_iftraffic5.pl

Perl 5.10

Project Notes
check_iftraffic5.pl - Nagios(r) network traffic monitor plugin Copyright (C) 2012 Mike Pagano Based on Gerd Mueller's check_iftraffic.pl Contributions by: Adrian Wieczorek, Ektanoor, Markus Werner, Greg Frater and Richard Walraven Remarks: * Supports all Cisco standard interfaces: TenGigabitEthernet, GigabitEthernet, FastEthernet, Ethernet, Port-channel, Vlan. Also works on standard NIC adaptors. * Checks input/output traffic, unicast pkts, multicast pkts, broadcast pkts, errors and discards on a single interface. * Checks Port-channel member status by comparing port-channel speed to number. * Performance data formatting meets Nagios standards. + Provides stats for bandwidth by percentage and integer values. + Packets in/out for unicast, multicast & broadcast. + Number of in/out packet discards & errors. + Designed specifically for charting with "Splunk for Nagios". + Other reporting programs can use perfdata. IE RRD. * Checks for interface administrative and operational status up/down. Down on either returns a critical state. * Allows either textual or the numeric index value of an interface. * If the interface speed is not specified on the command line it gets it automatically from IfSpeed. * Bandwidth options allow checks of: Asymmetrical links such as a DSL line or cable modem where the download and upload speeds are different. Minimum input bandwidth useful for IPSEC tunnels. * Can determine interface to query by matching IP address of host with entry in ipAdEntIfIndex (.1.3.6.1.2.1.4.20.1.2). * Bits per second are the default now. Use -B for bytes. * RX, TX and absolute values show bytes/octets only. * SNMP version 2 as we need 64-bit counters. The 32-bit overflows too fast and too frequently. * Automatic detection of snmp overflows generates a warning state. Max value used -M. * Perl's given-where "switch" in some places. Look for the correct "use" for your version of perl. * Supports Perl 5.10 * -h displays help information to see avaliable options. Suggestions: Use -b, --bandwidth with -u, --units. This allows for simple input of interface parameters. Usage -u g=gigabits/s,m=megabits/s,k=kilobits/s,b=bits/s. Example for a 1 Gig interface: check_iftraffic42.pl -H host1 -C sneaky -i GigabitEthernet1/2 -b 1 -u g Nagios command: $USER1$/check_iftraffic42.pl -H $HOSTADDRESS$ -C $USER3$ -i $ARG1$ -b $ARG2$ -u $ARG3$ -w $ARG4$ -c $ARG5$ Example for a 2 Gig Port-channel check_iftraffic42.pl -H host1 -C sneaky -i Port-channel1 -b 2 -u g –P 2000000000 Nagios command: $USER1$/check_iftraffic42.pl -H $HOSTADDRESS$ -C $USER3$ -i $ARG1$ -b $ARG2$ -u $ARG3$ -P $ARG4$ -w $ARG5$ -c $ARG6$
Reviews (9) Add a Review
Graph not showing
by sujit_m, January 31, 2022
while using this plugin graph is showing empty with no data.
could you please help with this?
Helpful?    
Report
nagvis
by thiccboi, February 29, 2020
Will this plugin work with nagvis?
Anyone tried it out?
Helpful?    
Report
how about snmp v3 support
by Majed, August 31, 2015
i wanted to monitor cisco nexus 5000 but it needs snmpv3 so why not support it?
Helpful?    
Report
work well but needs PPS
by struiaj17, October 31, 2014
The script worked well once I created the directory for storing the cache files. The path was different in Ubuntu. Also, it would be really nice to have an option to track packets per second. A patch (check_iftraffic5-pps.pl.patch.txt) was available at one point but is now offline.
Helpful?    
Report
PPS
by ugenk, March 31, 2013
I've added ability to monitor not only bandwidth, but also PPS (unicast packets per second). Here is the patch:
http://download.datahata.by/check_iftraffic5-pps.pl.patch.txt
Helpful?    
Report
help
by galid_elmouha, March 31, 2013
Hi

Im using a catalyst 3550 and if i use the script true commandline i get 0 values everywhere.. AverageIn:0.00bps, AverageOut: 0.00bps,.. any ideas?

tnx
Helpful?    
Report
event handler
by rwalraven, January 31, 2012
need help as to why the exit status is not trigger eventhandlers to run.
Helpful?    
Report
Needed to reverst to 32-bit for Windows
by sjorge, October 31, 2011
I had to change to the old 32-bit counters for my windows server, took me about 30 min to figure out.

I added an extra switch (x) to set it to 32 when needed.

Patch Below:
--------------
nagios@deimos ~/test $ diff check_iftraffic42.pl check_iftraffic42.pl.original
123,126c123,128
#Older 32-bit counter:
> #my $snmpIfOutOctets = '1.3.6.1.2.1.2.2.1.16';
> my $snmpIfOutOctets = '1.3.6.1.2.1.31.1.1.1.10';
150d151
tOctets32;
1 of 1 found this review helpful.
Helpful?  1  0
Report
64 bit counter madness
by themtz, September 30, 2011
Since the switch to 64 bit counters i am getting totally weird average values like:

CRITICAL - Average IN: 3.41Tbps (170252.50%), Average OUT: 970.95Gbps (48547.45%) Total RX: 5.81TBytes, Total TX: 1.66TBytes|inUsage=170252.50%;85;98 outUsage=48547.45%;85;98 inBandwidth=3405050072654.40bps outBandwidth=970948946016.00bps inAbsolut=6384549288059 outAbsolut=1820440453052 Bandwidth=2000000000

The old version with 32 bit counters works fine, but of course it loops all the time on my fast interfaces.

Any idea ?

PS: Checked system is a Cisco Catalyst 4510 and several 2960
Owner's Reply:

At line 547 please change %.01d to %s. This should take care of it.

if ( open(FILE,">".$TRAFFIC_FILE."_if".$iface_number."_".$host_address )) {
printf FILE ("%s:%s:%s
", $update_time, $in_bits, $out_bits );
close(FILE);
};

2 of 2 found this review helpful.
Helpful?  2  0
Report
Add a Review

You must be logged in to submit a review.

Thank you for your review!

Your review has been submitted and is pending approval.

Recommend

To:


From:


Thank you for your recommendation!

Your recommendation has been sent.

Page Sections
Project Overview Project Files Project Notes Reviews
Project Stats
Rating
4.3 (11)
Favorites
1
Views
105,774