====== Nagiosgraph ======
Nagiosgraph zeigt grafische Verläufe verschiedener Stati der einzelnen Hosts und deren Services.

<note tip>muss überarbeitet werden</note>

===== Download =====
<code bash>mkdir -p /data/nagiosgraph
cd /data/nagiosgraph
wget wget http://downloads.sourceforge.net/project/nagiosgraph/nagiosgraph/1.5.2/nagiosgraph-1.5.2.tar.gz
tar xfz nagiosgraph-<VERSION>.tar.gz</code>

===== Installation =====
Nach dem Entpacken müssen noch einige Abhängigkeiten erfüllt werden.
<code bash>apt-get install rrdtool perl libcgi-pm-perl librrds-perl libgd-gd2-perl
perl -MCPAN -e 'install Nagios::Config'</code>

Nun können wir mit dem folgenden Befehl schauen ob alle Abhängigkeiten erfüllt sind.
<code bash>cd nagiosgraph-<VERSION>
./install.pl --check-prereq</code>
Danach Installieren wir Nagiosgraph, vorher sollte Nagios gestoppt werden.
<code bash>service nagios stop
./install.pl --layout standalone --prefix /usr/local/nagiosgraph</code>
Mit folgendem Befehl können wir die installation überprüfen
<code bash>./install.pl --check-installation</code<

==== Konfiguration ====
Folgende Dateiberechtigungen müssen jetzt manuell noch gesetzt werden.
<code bash>chown -R nagios /var/nagiosgraph
chmod -R 755 /var/nagiosgraph
mkdir /var/log/nagiosgraph
chown www-data:nagios /var/log/nagiosgraph
chmod 664 /var/log/nagiosgraph
mkdir -p /var/nagios
chown -R nagios.root /var/nagios
chown -R nagios.root /usr/local/nagiosgraph</code>

In der //nagios.cfg// müssen noch diese Einträge gesetzt oder neu hinzugefügt werden.
<code bash>vi /usr/local/nagios/etc/nagios.cfg</code>
Inhalt prüfen ggf. setzen oder hinzufügen:
<code>process_performance_data=1
service_perfdata_file=/var/nagios/service-perfdata
service_perfdata_file_template=$LASTSERVICECHECK$||$HOSTNAME$||$SERVICEDESC$||$SERVICEOUTPUT$||$SERVICEPERFDATA$
service_perfdata_file_mode=a
service_perfdata_file_processing_interval=30
service_perfdata_file_processing_command=process-service-perfdata-file</code>
     
Die letzte Zeile enthält einen neuen Befehl für Nagios, den Nagios noch nicht kennt.
Diesen legt man entweder mit einem Tool wie z.B. Nagiosql oder direkt mit einem Eintrag in der //commands.cfg// an.
<code bash>vi /etc/nagios/objects/commands.cfg</code>
Inhalt einfach unten einfügen:
<code>define command {
    command_name  process-service-perfdata-file
    command_line  /usr/local/nagiosgraph/bin/insert.pl
}</code>

**WICHTIG:** Dies ist ein eigenes Kommando. Ich hatte bereits die Kommandos für //process-service-perfdata// und //process-host-perfdata// bei meinem Nagiosql3 enthalten. Also diese dann nicht überschreiben oder deaktivieren.

Da man nicht alle Services mit Nagiosgraph darstellen möchte, sollte man sich hier eine Vorlage erstellen welche dann mit den bevorzugten Objekten verknüpft wird.
Hier wieder selbst editieren oder per Tool konfigurieren.
<code bash>vi /etc/nagios/objects/templates.cfg</code>
Inhalt einfach unten einfügen:
<code>define service {
name graphed-service
action_url /nagiosgraph/cgi-bin/show.cgi?host=$HOSTNAME$&service=$SERVICEDESC$' onMouseOver='showGraphPopup(this)' onMouseOut='hideGraphPopup()' rel='/nagiosgraph/cgi-bin/showgraph.cgi?host=$HOSTNAME$&service=$SERVICEDESC$&period=week&rrdopts=-w+450+-j
}</code>

Jetzt ersetzen wir noch das ursprüngliche Nagios Bild "action" mit dem Nagiosgraph Bild.
<code bash>cp share/graph.gif /usr/local/nagios/share/images/action.gif</code>
In der Nagiosgraph SSI Datei passen wir noch diese an:
<code bash>vi share/nagiosgraph.ssi</code>
<code>src="/nagiosgraph/nagiosgraph.js"   ->    src="/nagios/nagiosgraph.js"</code>
Danach installieren wir diese.
<code bash>cp share/nagiosgraph.ssi /usr/local/nagios/share/ssi/common-header.ssi
cp share/nagiosgraph.js /usr/local/nagios/share/</code>
Mit der oben beschriebenen Skripinstallation wird das Verzeichnis ''/etc/nagiosgraph'' erstellt. Nagiosgraph hat aber ein eigenes "etc" Verzeichnis
unter ''/usr/local/nagiosgraph/etc'' diese Verzeichnisse sollte man am Besten zusammenführen.
<code bash>mv /etc/nagiosgraph/* /usr/local/nagiosgraph/etc/
rm -r /etc/nagiosgraph
ln -s /usr/local/nagiosgraph/etc /etc/nagiosgraph</code>

Jetzt noch nagiosgraph selbst konfigurieren.
<code bash>vi /etc/nagiosgraph/nagiosgraph.conf</code>
Hier folgende Zeilen anpassen:
<code>logfile = /var/log/nagiosgraph/nagiosgraph.log

# Location of output from nagiosgraph CGI scripts
cgilogfile = /var/log/nagiosgraph/nagiosgraph-cgi.log

# Location of nagios performance data log file.
perflog = /var/nagios/service-perfdata</code>

==== Nagios Website ====
Nagiosgraph kann man auch direkt von der Nagios-Core Webseite erreichen. Dafür erweitert man die Nagios sidebar.
<code bash>vi /usr/local/nagios/share/side.php</code>
Inhalt unter dem "Trend" heading hinzufügen.
ACHTUNG: Die Zeile mit "trends.cgi" durch die folgenden Zeilen ersetzen:
<code><li><a href="<?php echo $cfg["cgi_base_url"];?>/trends.cgi" target="<?php echo $link_target;?>">Trends</a>

<?php $NagiosgraphPath="../nagiosgraph/cgi-bin"; ?>
<ul>
<li><a href="<?php echo $NagiosgraphPath; ?>/show.cgi" target="<?php echo $link_target;?>">Graphs</a></li>
<li><a href="<?php echo $NagiosgraphPath; ?>/showhost.cgi" target="<?php echo $link_target;?>">Graphs by Host</a></li>
<li><a href="<?php echo $NagiosgraphPath; ?>/showservice.cgi" target="<?php echo $link_target;?>">Graphs by Service</a></li>
<li><a href="<?php echo $NagiosgraphPath; ?>/showgroup.cgi" target="<?php echo $link_target;?>">Graphs by Group</a></li>
</ul></li></code>

==== Apache ====
Wenn zu Anfang das Installationsscript nicht angewiesen wurde den Apache zu konfigurieren,
dann muß dieser wie folgt angewiesen werden die Konfigurationsdatei von Nagiosgraph zu nutzen.
<code bash>vi /etc/apache2/httpd.conf</code>
Inhalt einfach unten einfügen:
<code>include /usr/local/nagiosgraph/examples/nagiosgraph-apache.conf</code>

Zum Abschluss noch Nagios und den Apache2 neustarten.
<code bash>service nagios restart
service apache2 restart</code>

Nun können wir uns zum ersten mal an der Nagiosgraph Webseite anmelden.
[[http://localhost/nagiosgraph/cgi-bin/show.cgi|http://localhost/nagiosgraph/cgi-bin/show.cgi]]