
check_traffic v 0.91 beta - Traffic monitor plugin for Nagios(r)

(c) 2003 Adrian Wieczorek, <ads (at) irc.pila.pl>

i. Version 0.91 beta is repackaging of Version 0.90b with updated 
make-config scrips and a set_perms script to assist users in setting 
up permissions for the RRD files.  The fixes to make-config enable 
the proper creation of interface names on cisco (and other) routers 
as well as several other minor patches.

1. Introduction

 check_traffic is a simple addon to Nagios(r) written in Perl used to 
monitor network interfaces over SNMP protocol. You can use it to check 
current bandwidth utilization and total transmitted bytes. Just like in 
other Nagios(r) plugins You can define WARNING and CRITICAL level of 
traffic allowing to notify when something goes wrong.Plugin can store 
all data in RRD files (Round Robin Databese) and shows attractive network 
traffic graphs like MRTG or NRG utilities.

Nagios is a registered trademark of Ethan Galstad. 


2. Requirements

 To use this plugin you should have installed:

 1) Nagios(r) (http://www.nagios.org). Package was sucessfuly tested
    with version 1.0.

 2) SNMP utilities like 'snmpget' and 'snmpwalk', and read-only access
    to SNMP daemon on host You want to monitor.

 3) Perl interpreter. (tested with version 5.6.1 and 5.8.0)

 4) RRDTool package (http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/)
    if you want to generate traffic graphs.

 Plugin was tested on two Linux platforms: RedHat 7.3 and Redhat 8.0, but
 it should work correctly on other distributions.



3. Quick install


 1) Unpack package in Nagios home directory. (eg: /usr/local/nagios)

 2) Set correct path's and other vars in 'make-config' and 'check_traffic.pl'
    script. (DONT set $OUTPUP_* files to real Nagios /etc directory! You
    should copy all definitions to REAL Nagios config manually to avoid file
    corrupt.)

 3) Move libexec/check_traffic.pl script to Nagios plugin directory
    (eg. /usr/lib/nagios/plugins)

 4) Run 'make-config' script to automagically discover all network interfaces
    on host you want to monitor, and generates RRD cgi files and databases.
    All object definitions config files will be created in current directory.
 
 5) Now You can add interesting services and check command from generated files 
    to Nagios config. If You want use RRD cgi cripts don't forget about 
    hostextinfo definitions.

 6) Make sure the $DB_PATH directory is writable for Nagios, and $GIFS_PATH is
    writable for user running CGI scripts (eg. apache).

 7) Move gererated RRD .cgi scripts to Nagios libexec directory, and
    traffic-icon.jpg file to share/images/logos.

 8) Reload Nagios daemon.

 IMPORTANT: If you run check_traffic.pl script from shell with different user
 remove all /tmp/traffic-* before adding this script to Nagios. (permissons!)
 

 This is initial release of this plugin, feel free to inform me about bugs and
suggestions.

Visit: http://adi.blink.pl/nagios/

Adrian Wieczorek, ads@irc.pila.pl


 
