check_traffic

Diese Anleitung ist mit der check_traffic Plugin Version 0.90b entstanden.

Das Plugin „check_traffic“ ist ein einfaches Addon für Nagios. Es ist in Perl geschrieben und dient dazu, Netzwerkschnittstellen über das SNMP Protokoll zu überwachen. Überprüft und Aufgezeichnet werden die gegenwärtige Bandbreite und die übertragenen Bytes. Wie bei anderen Nagios Plugins kann man hier auch WARNING und CRITICAL Schwellenwerte angeben, die uns eine Benachrichtigung zukommen lassen, wenn etwas aus dem Ruder läuft. Das Plugin kann zusätzlich noch alle Daten in RRD (Round Robin Database) Dateien speichern, um attraktive Netzwerk Traffic Graphen wie MRTG zu erzeugen.

Abhängigkeiten: snmpget, snmpwalk, Perl Interpreter (v. 5.6.1 oder v. 5.8.0), RRDTool

1) Packet in Nagios Home Verzeichnis entpacken. (z.B. /usr/local/nagios)

2) Richtige Pfade und andere Variablen in den Dateien 'make-config' und 'check_traffic.pl' setzen.

 Achtung: 
 $OUTPUP_* Dateien nicht auf das richtige Nagios /etc Verzeichnis setzen !
 Man sollte alle Definitionen per Hand an die richtigen Stellen in Nagios kopieren um korrupte Dateien zu verhindern.

• make_config
  • $HOST = „IP des zu überwachenden Hosts“
  • $HOSTNAME = „Name (im Nagios) des zu überwachenden Hosts“
  • $OUTPUT_SERVICE_FILE = “/usr/local/nagios/traffic/services.cfg“;
  • $OUTPUT_COMMANDS_FILE = “/usr/local/nagios/traffic/checkcommands.cfg“;
  • $OUTPUT_EXTINFO_FILE = “/usr/local/nagios/traffic/serviceextinfo.cfg“;
  • $GIFS_URL = „http://xxx/nagios/“;
  • $CGI_URL = “/nagios/cgi-bin“;

3) Verschiebe libexec/check_traffic.pl ins Nagios Plugin Verzeichnis. Und mache es ausführbar.

  (z.B. /usr/local/nagios/libexec )

4) Führe 'make-config' aus um automatisch alle Netzwerk Interfaces auf dem Host, der überwacht werden soll zu entdecken. RRD cgi Dateien und die zugehörigen Datenbanken werden dabei erzeugt. Alle Objekt Definitionen und Konfig Dateien werden im 'current' Verzeichnis erstellt.

5) Die gewünschten Dienste werden an die richtigen Stellen gebracht.

„ more services.cfg >> /usr/local/nagios/etc/services.cfg“ 

 # 'em0' serviceextinfo  definition
define serviceextinfo{
              host_name               Host-Name
              service_description     em0 Traffic
              notes_url               /nagios/cgi-bin/Host-IP_em0.cgi
              icon_image              traffic-icon.jpg
              icon_image_alt          View graphs
}

Ebenso kopiert man das Checkkommando in das Nagios checkcommands File. Wenn man RRD CGi Scripte verwenden will darf man die Serviceextinfo Definitionen nicht vergessen. Ebenfalls müsen die CGI's ins Nagios CGI Verzeichnis transferriert und die Rechte entsprechend gesetzt werden.

6) Der $DB_PATH muss für den User Nagios beschreibbar sein und der $GIFS_PATH sollte für den Benutzer beschreibbar sein, der die CGI Scripte ausführt ( z.B. der Apache User )

7) Die RRD .cgi Scripte müssen in das Nagios libexec Verzeichnis und das traffic-icon.jpg nach share/images/logos.

8) Man kann den check_traffic Befehl per Hand ausführen, um zu sehen ob alles funktioniert hat.

/usr/local/nagios/libexec/check_traffic –H <Hostadresse> –i 2 –b 1200000 –r em0

          Total RX Bytes: 3826.86 MB, Total TX Bytes: 3732.37 MB
          Average Traffic: 3.57 B/s (0.0%) in, 3.48 B/s (0.0%)
  

  Usage: check_traffic -H host -i if_number -b if_max_speed [-r if_description] [ -w warn ] [ -c crit ]
  
  Options:
   -H --host STRING or IPADDRESS
    Check interface on the indicated host.
   -i --interface INTEGER
    Interface number assigned by SNMP agent.
   -b --bps INTEGER
    Interface maximum speed in bytes per second.
   -r --rrd STRING
    Interface description used to store values in correct RRD file.
   -w --warning INTEGER
    % of bandwidth usage necessary to result in warning status
   -c --critical INTEGER
    % of bandwidth usage necessary to result in critical status

9) Nagios neu starten

Auf dem Client muss der SNMP Daemon installiert und gestartet werden. (http://www.nagios-wiki.de/doku.php/nagios/plugins/check_snmp)

/etc/snmpd.conf
rocommunity public 127.0.0.1 ( IP Adressse des Nagios Hosts angeben )

Das check_traffic Plugin befindet sich unter den Nagios Standard Plugins. Die Nagios Plugin Version 1.4.3 enthält 2 Versionen die Version 0.90b und 0.91b.

/nagios-plugins-1.4.3/contrib/tarballs/check_traffic-0.9
check_traffic-0.90b.tar.gz  check_traffic-0.91b.tar.gz

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

— broesel0815 11.09.2006 13:58