Einrichtung NagiosGrapher unter Debian

Einrichtung NagiosGrapher unter Debian

Diese Anleitung bezieht sich auf eine Nagios 2.x Installation und Debian. Eingerichtet wird NagiosGrapher 1.71.

Vorraussetzungen

Nagios	Installiertes Nagios mit Webinterface
RRD Tool	Installiertes RRD Tool
Perl Module	CGI
	CGI::Carp
	Calendar::Simple
	Carp
	Data::Dumper
	File::Basename
	File::Copy
	GD
	IO::Handle
	Image::Magick
	POSIX
	RRDs
	Storable
	Time::HiRes
	Time::Local
	URI::Escape

Einrichtung

RRDTool / Perlmodule

Folgender Befehl installiert alle benötigten Pakte um Nagios Grapher unter Debian Linux zu installieren

apt-get install autoconf rrdtool perl perl-base perl-modules libcalendar-simple-perl libgd-gd2-perl perlmagick librrds-perl liburi-perl

Nagios Grapher 1.71

Download NagiosGrapher von SourceForge.net

wget http://mesh.dl.sourceforge.net/sourceforge/nagiosgrapher/NagiosGrapher-1.7.1.tar.gz

Automatische Konfiguration (neu)

autoconf

Sollte autoconf nicht funktionieren (alt)

./configure

Test ob alle PerlModule installiert sind

make testdeps

So sollte der Test aussehen

/usr/bin/perl ./tools/testdeps.pl
Checking Data::Dumper ... found
Checking File::Copy ... found
Checking File::Basename ... found
Checking Carp ... found
Checking POSIX ... found
Checking Time::HiRes ... found
Checking Time::Local ... found
Checking Storable ... found
Checking GD ... found
Checking Image::Magick ... found
Checking RRDs ... found
Checking CGI ... found
Checking CGI::Carp ... found
Checking IO::Handle ... found
Checking URI::Escape ... found
Checking Calendar::Simple ... found

Installation NagiosGrapher

make install

Konfiguration Nagios

Anpassung Nagios Konfiguration

nagios.cfg

In dieser Datei müssen folgende Einstellungen geändert werden

cfg_dir=/usr/local/nagios/etc/serviceext
process_performance_data=1
service_perfdata_file=/usr/local/nagios/var/service-perfdata
service_perfdata_file_template=$HOSTNAME$\t$SERVICEDESC$\t$SERVICEOUTPUT$\t$SERVICEPERFDATA$\t$TIMET$
service_perfdata_file_mode=a
service_perfdata_file_processing_interval=30
service_perfdata_file_processing_command=process-service-perfdata-file

Anpassung der Commands

commands.cfg

Zusätzlich muss noch ein weiteres Command angelegt werden

define command{
            command_name process-service-perfdata-file
            command_line mv /usr/local/nagios/var/service-perfdata /usr/local/nagios/var/service-perfdata.$TIMET$
            }

Konfiguration NagiosGrapher

Übersicht Verzeichnisse / Dateien

Configfile	/usr/local/nagios/etc/ngraph.ncfg
Definitionen Graphen	/usr/local/nagios/etc/ngraph.d/
Definition Multigraphen	/usr/local/nagios/etc/mngraph.ncfg

Configfile

define config {

    port                    5667
    buffer                  1024
    interface               file
    # pipe                  /usr/local/nagios/var/rw/ngraph.pipe
    perffile_path           /usr/local/nagios/var/

    # please use subfolder
    pidfile                 /usr/local/nagios/var/nagios_grapher/nagios_grapher.pid
    user                    nagios
    group                   nagios

    # disable reading of Nagios-object cache
    skip_object_cache       false

    # normal_check_interval
    step                    300

    # VALUE (e.g. 600 for 5 minutes ) or AUTO
    heartbeat               AUTO

    rrdpath                 /usr/local/nagios/var/rrd/
    tmppath                 /tmp/nagiosgrapher

    fontfile                /usr/share/fonts/truetype/ttf-dejavu/DejaVuSansCondensed.ttf

    serviceext_type         MULTIPLE
    serviceextinfo          /usr/local/nagios/etc/serviceextinfo.cfg
    serviceext_path         /usr/local/nagios/etc/serviceext

    url                     /nagios/cgi-bin/graphs.cgi
    # notes_url              /wiki/index.php/$HOSTNAME$#$SERVICEDESC$
    notes_url

    nagios_config           /usr/local/nagios/etc/nagios.cfg
    cgi_config              /usr/local/nagios/etc/cgi.cfg

    icon_image_tag          ' dot.png' alt="###ALT###" border="0"></a><A TARGET="_blank" HREF="graphs.cgi?###URL###"><img src="###IMAGESRC###" '
    icon_image_src          /nagios/images/logos/graph.png
    icon_image_script       /nagios/cgi-bin/rrd2-system.cgi?###URL###&start=-5400&title=Actual&width=20&height=20&type=AVERAGE&only-graph=true
    icon_image_static       true

    log_file                /usr/local/nagios/var/ngraph.log
    log_level               1023

    rrd_color_background    ffffff
    rrd_color_font          333333
    rrd_color_arrow         ff0000
    rrd_color_frame         ffffff
    rrd_color_grid
    rrd_color_canvas        ffffff
    rrd_color_shadea        c0c0c0
    rrd_color_shadeb        c0c0c0

    rrd_show_vlines         true

    fe_use_browser_all      false
    fe_use_browser_for      nagiosadmin
    fe_use_browser_url      false

    fe_use_timefilter       true

    use_authentication      true

    # define default host and default service for your start page
    # values (host name and service name)are supposed to be exactly the same as
    # defined in your nagios configuration or as found in your NG-drop-down boxes
    #
    # default_host            some_host_name
    # default_service         * All Services

    #
    # HOOKS: Comma seperated list of perl modules ...

    # All hooks before an srvext entry is created
    # hooks_serviceext        NagiosGrapher::Hooks::SrvExtTest

    # Hooks before RRD is updated
    # hooks_rrdupdate         NagiosGrapher::Hooks::RRDUpdateTest

    # Example hook for writing a hostextinfo
    # With the action=hostgraph example ...
    # The module runs under hooks_serviceext too ...
    # hooks_rrdupdate         NagiosGrapher::Hooks::SrvExtWriteHostextInfo


    # Bevor Multi- and Singlegraphs, but different types.
    # Hooks before an image is displayed
    # hooks_imagegraph        NagiosGrapher::Hooks::ImageGraphTest

    # Example for invoking multiple hooks ...
    # hooks_imagegraph        NagiosGrapher::Hooks::ImageGraphTest,NagiosGrapher::Hooks::ImageGraphTest

}

# Includes
cfg_dir=/usr/local/nagios/etc/ngraph.d

# [EOF] (Don't remove this line ...)

Die Konfiguration des NagiosGrapher muss bei einer „normalen“ Installation nicht verändert werden. Wichtig ist vor allem die Zeile

cfg_dir=/usr/local/nagios/etc/ngraph.d

Der NagiosGrapher sucht in diesem Ordner inkl. aller Unterordner nach gültigen Definitionen.

Definitionen Graphen

Out-of-the-box werden in diesem Verzeichnis vorkonfigurierte Graphen definiert. Abgelegt sind diese in 2 Unterordnern.

/usr/local/nagios/etc/ngraph.d/templates/standart	Einige Graphen für Ping, SMTP, Http, usw
/usr/local/nagios/etc/ngraph.d/templates/extra	Zusätzliche Graphen Smtp, Spamassassin, usw

Die Inhalte beider Dateien sollten zur besseren Übersicht direkt ins Hauptverzeichnis /usr/local/nagios/etc/ngrapp.d verschoben werden. Der NagiosGrapher reagiert sehr empfindlich was doppelte Konfigurationen betrifft (am Besten keine Unterordner erstellen, da hier die Gefahr besteht doppelte Konfigurationen zu übersehen). Deaktivierte Templates haben im Dateinamen ein _disabled stehen.