Informationen über die CGI Programme


Einleitung

Die unterschiedlichen Nagios CGI-Programme werden neben den Autorisierungsvoraussetzungen für Zugriff und Verwendung derselben hier beschrieben. Per Default erfordern die CGI Programme (CGIs), dass Sie sich über den Webserver authentifiziert haben um die angeforderte Information zu sichten. Für weiterführende Informationen betreffend der diesbezüglich notwendigen Konfiguration des Webservers und des CGI Configuration Files, lesen Sie die Abschnitte Installation des Web-Interface sowie CGI Authentifizierung und -Autorisierung.

Inhaltsverzeichnis

Status CGI
Status map CGI
WAP interface CGI
Status world CGI (VRML)
Tactical Overview CGI
Network outages CGI
Configuration CGI
Command CGI
Extended information CGI
Event log CGI
Alert history CGI
Notifications CGI
Trends CGI
Availability reporting CGI
Alert histogram CGI
Alert Summary CGI

Status CGI
Status CGI - Details Status CGI - Überblick Status CGI - Zusammenfassung Status CGI - Grid
File Name: status.cgi

Beschreibung:
Das wichtigste CGI-Programm, das Nagios beigefügt ist. Es gestattet die Sicht auf den aktuellen Status aller momentan überwachten Rechner und Services. Das Status CGI ist in der Lage zwei wesentliche Arten der Ausgabe zu erzeugen - eine Statusübersicht über alle Rechnergruppen (oder einer bestimmten Rechnergruppe) und eine Detailsicht auf alle Services (oder jene die im Zusammenhang mit einem bestimmten Rechner stehen). Hübsche Icons können mit den Rechnern über die erweiterten Host und Service Informationen Definitionen verknüpft werden.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert sind Sie berechtigt auf alle Host- und deren Service-Informationen zuzugreifen.
  • Sind Sie für alle Services dürfen Sie alle Service-Informationen abrufen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie auf alle Host- und Service-Informationen, für die Sie als Kontaktperson definiert sind, Zugriff.

Status Map CGI
Status Map CGI
File Name: statusmap.cgi

Beschreibung:
Dieses CGI erzeugt einen Plan über alle Hosts die im Netzwerk zur Überwachung definiert sind. Das CGI verwendet Thomas Boutell's gd Library (Version 1.6.3 oder höher) für die Erstellung einer Layout-Grafik Ihres Netzwerkes im PNG-Format. Die für die Erstellung verwendeten Koordinaten der jeweiligen Hosts (gemeinsam mit den optional hübschen Icons) werden aus den extended host information Definitionen bezogen. Wenn Sie es vorziehen dem CGI die Koordinaten selbst bestimmen zu lassen, verwenden Sie die default_statusmap_layout Anweisung um jenen Layout-Algorithmus zu bestimmen, der dafür verwendet werden soll. Wenn Sie dieses CGI nicht auffinden können, oder wenn Sie beim Versuch das CGI zu kompilieren oder beim Aufruf Fehler bekommen, lesen Sie diese FAQ.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert sind Sie berechtigt auf alle Hostsinformationen zuzugreifen.
  • Sind Sie eine autorisierte Kontaktperson dürfen Sie alle Hosts sichten, für die Sie als Kontaktperson definiert sind.

Bemerkung: Benutzer, die nicht berechtigt sind spezielle Hosts sichten zu dürfen, sehen an deren Stelle unbekannte Knoten. Ich sehe ein, dass diese Benutzer an dieser Stelle nichts sehen sollten, aber andereseits würde es keinen Sinn machen einn Plan zu erzeugen und dabei nicht die Abhängigkeiten anzuzeigen ...

WAP Interface CGI
WAP Interface CGI
File Name: statuswml.cgi

Beschreibung:
Dieses CGI liefert als WAP Interface Netzwerk Status Informationen. Wenn Sie ein WAP-fähiges Endgerät haben (z.B. ein internetfähiges Telefon), können Sie Status Information während Ihrer Abwesenheit abrufen. Unterschiedliche Sichten zeigen eine Zusammenfassung der Hostgruppe, Übersicht über die Hostgruppen, Host- Service-Detailsicht, alle Probleme und unbehandelten Probleme. Zusätzlich zu den angezeigten Statusinformation, können Sie auch Benachrichtigungen und Checks stoppen, sowie Probleme vom Telefon aus bestätigen. Ziemlich cool, oder?

Autorisierungsvoraussetzungen:

Status World CGI (VRML)
3-D Status Map CGI
File Name: statuswrl.cgi

Beschreibung:
Dieses CGI erzeugt ein 3-D VRML Modell über alle Hosts die Sie für Ihr Netzwerk definiert haben. Beim Zeichnen der Hosts werden die Koordinaten (ebenso wie die hübschen Grafiken) aus den Definitionen der Extended Host Informationen gebildet. Sollten Sie es vorziehen wollen das CGI automatisch die Koordinaten generieren zu lassen, verwenden Sie die default_statuswrl_layout Anweisung um den Layoutalgorithmus der verwendet werden soll zu bestimmen. Sie werden einen VRML Browser (wie Cortona, Cosmo Player oder WorldView) auf Ihrem System installieren müssen um das generierte Modell betrachten zu können.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie sich alle Hosts ansehen.
  • Sind Sie eine autorisierte Kontaktperson können Sie alle Hosts betrachten, für die Sie als Kontaktperson definiert sind.

Bemerkung: Benutzern die nicht berechtigt wurden spezielle Hosts anzusehen wird an diesen Stellen unknown angezeigt. Ich bin mir der Tatsache bewusst, dass diese Benutzer ansich nichts an dieser Stelle sehen sollten, aber es macht keinen Sinn einen Plan zu generieren auf dem man keine Host-Abhängigkeiten erkennen kann ...

Tactical Overview CGI
Tactical Overview CGI
File Name: tac.cgi

Beschreibung:
Dieses CGI wurde erstellt um einen Blick aus der "Vogelperspektive" auf alle im Netzwerk überwachten Aktivitäten zu gestatten. Sie sind in der Lage rasch Netzwerkstörungen, Host- und Service-Stati zu erkennen. Es wird zwischen Problemen die bereits behandelt (z.B. been acknowledged, had notifications disabled, etc.) und jenen die noch nicht behandelt werden und zu beachten sind, unterschieden. Diese Sicht ist sehr hilfreich, wenn Sie eine Unmenge an Hosts/Services zum Überwachen haben und Sie dafür eine einzige Anzeige verwenden wollen um auf ein Problem aufmerksam gemacht zu werden.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie alle Host und alle Services betrachten.
  • Sind Sie für alle Services autorisiert dürfen Sie sich alle Services ansehen.
  • Sind Sie eine authentisierte Kontaktperson haben Sie das Recht sich alle Hosts und Services für die Sie als Kontaktperson definiert sind anzusehen.

Network Outages CGI
Network Outages CGI
File Name: outages.cgi

Beschreibung:
Dieses CGI erzeugt eine Aufstellung von "Problem" Hosts im Netzwerk die Netzwerkstörungen verursachen. Dies kann wenn Sie ein großes Netzwerk überwachen hilfreich sein, wenn Sie rasch jene Ressource identifizieren wollen die das Problem verursacht. Die Sortierung erfolgt gemäß der Schwere der Störung. Weiterführende Informationen darüber wie das CGI Netzwerk Störung abhandelt, finden Sie hier.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie alle Hostinformationen abrufen.
  • Sind Sie eine autorisierte Kontaktperson können Sie Informationen jener Hosts abrufen für die Sie als Kontaktperson definiert sind.

Configuration CGI
Configuration CGI
File Name: config.cgi

Beschreibung:
Dieses CGI gestattet es Objekte (z.B. Hosts, Host Gruppen, Kontakte, Kontaktgruppen, Zeitspannen, Services, usw.) die Sie in Ihrem(n) Object Configuration File(s) definiert haben anzusehen.

Autorisierungsvoraussetzungen:

Command CGI
Command CGI
File Name: cmd.cgi

Beschreibung:
Dieses CGI erlaubt Befehle zur Durchführung an die Nagioszentrale zu senden. Obgleich dieses CGI verschiedenste Argumente verarbeiten kann, wird empfohlen diese nicht anzugeben. Die meisten Veränderungen ergebn sich durch die Versionswechsel von Nagios. Verwenden Sie das Extended Information CGI als Ausgangspunkt um Befehle einzugeben.

Autorisierungsvoraussetzungen:

Bemerkungen:

  • Wenn Sie sich gegen die Verwendung einer CGI Authentifizierung entschieden haben, gestattet dieses CGI niemandem Befehle abzusetzen. Das dient ihrer eigenen Sicherheit. Ich schlage vor dieses CGI zu entfernen, wenn Sie sich gegen eine CGI Authentifizierung entschieden haben.
  • In Abhängigkeit der über dieses CGI durchzuführenden Befehle, sind die jeweiligen bezughabenden File- und Verzeichnis-Zugriffsrechte wie in diesem FAQ beschrieben entsprechend zu setzen.

Extended Information CGI
Extended Information CGI - Process Information Extended Information CGI - Performance Information Extended Information CGI - Host Information Extended Information CGI - Service Information
File Name: extinfo.cgi

Beschreibung:
Dieses CGI erlaubt es auf Nagios Prozess Information zuzugreifen, d.s. Host und Service Statusstatistiken, Host und Service Kommentare, uvm. Es dient auch als Ausgangspunkt für das Senden von Befehlen an Nagios über das Command CGI. Wennauch dieses CGI in der Lage ist verschiedenste Argumente abzuarbeiten, wird geraten diese nicht zu verwenden. Sie können dieses CGI aufrufen indem Sie auf den Link 'Network Health' oder 'Process Information' in der Navigationsleiste klicken, oder über das Anklicken eines Host- oder Service-Links des Status CGI.

Autorisierungsvoraussetzungen:

  • Sie müssen für System Information autorisiert sein um auf Nagios Prozessinformationen zugreifen zu können.
  • Sind Sie für alle Hosts autorisiert können Sie auf die erweiterten Information für alle Hosts und Services zugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie die erweiterten Informationen für alle Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson dürfen Sie all erweiterten Information aller Hosts und Services aufrufen für die Sie als Kontaktperson definiert sind.

Event Log CGI
Event Log CGI
File Name: showlog.cgi

Beschreibung:
Dieses CGI zeigt Ihnen den Inhalt des Log Files. Wenn Sie Log Rotation aktiviert haben, können Sie unter Verwendung der Navigationslinks auf archivierte Informationen zugreifen.

Autorisierungsvoraussetzungen:

Alert History CGI
Alert History CGI
File Name: history.cgi

Beschreibung:
Dieses CGI wird verwendet die Geschichtsvergangenheit von Problemen betreffend einzelner oder aller Hosts anzuzeigen. Die Ausgabe ist grundlegend eine Teilmenge von Information die über das Log File CGI angezeigt werden. Sie haben die Möglichkeit die Ausgabe so zu Filtern, dass nur eine gewünschte Art von Problemen angezeigt wird (z.B. Hard- und/oder Soft Alarmen, verschiedene Servicetypen und Host Alarme, alle Alarme, usw.). Wenn Sie Log Rotation aktiviert haben, sind sie in der Lage auf vergangene Informationen die in den Archiven abgelegt sind unter Verwendung der Navigationslinks zuzugreifen.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert sind Sie in der Lage auf die History-Informationen aller Hosts und aller Services zuzugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie auf die History-Informationen aller Services zugreifen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie Zugang zu allen History-Information für alle Services und Hosts für die Sie als Kontaktperson definiert sind.

Notifications CGI
Notifications CGI
File Name: notifications.cgi

Beschreibung:
Dieses CGI zeigt die Host und Service Benachrichtigungen die an die verschiedenen Kontaktpersonen abgesendet wurden an. Die Ausgabe ist eine Teilmenge jener Informationen die über das Log File CGI angezeigt werden. Sie haben die Möglichkeit Filter zu setzen um die Ausgabe auf bestimmte Benachrichtigungstypen zu beschränken (z.B. service Notifications, Host Notifications, an bestimmte Empfänger gerichtete Notificationen, usw). Wenn Sie Log Rotation aktiviert haben, sind sie in der Lage unter Verwendung der Navigationslinks auf Informationen die in den Archiven abgelegt sind zuzugreifen.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert dürfen Sie auf alle Benachrichtigungen aller Hosts und aller Services zugreifen.
  • Sind Sie für alle Services autorisiert können Sie die Benachrichtigungen für alle Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson können Sie auf all jene Benachrichtigungen für all jene Services und Hosts zugreifen für die Sie als Kontaktperson definiert sind.

Trends CGI
Trends CGI
File Name: trends.cgi

Beschreibung:
Dieses CGI erzeugt eine über einen beliebig gewählten Zeitraum grafische Aufstellung von Host oder Service-Stati. In Abhängigkeit davon wie häufig dieses Skript genutzt wird, sollten Sie Log Rotation aktivieren und archivierte Logs im über die log_archive_path Anweisung angegebenen Pfad aufbewahren. Das CGI verwendet Thomas Boutell's gd Library (Version 1.6.3 oder höher) um die Trendgrafiken anzufertigen. Lesen Sie diese FAQ, wenn Sie dieses CGI nicht finden können, oder wenn Sie beim Kompilieren oder beim Aufrufen einen Fehler erhalten.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie auf alle Trendgrafiken aller Hosts und aller Services zugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie die Trendgrafiken aller Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie Zugriff auf alle Trendgrafiken all jener Services und Hosts für die Sie als Kontaktperson definiert sind.

Availability Reporting CGI
Availability CGI - Hostgroup Availability CGI - Host
File Name: avail.cgi

Beschreibung:
Dieses CGI erzeugt einen Bericht über die Verfügbarkeit von Hosts und Services über einen vom Benutzer definierten Zeitraum. In Abhängigkeit davon wie häufig dieses Skript genutzt wird, sollten Sie Log Rotation aktivieren und archivierte Logs im über die log_archive_path Anweisung angegebenen Pfad aufbewahren.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie auf alle Verfügbarkeitsdaten aller Hosts und aller Services zugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie die Verfügbarkeitsdaten aller Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie Zugriff auf alle Verfügbarkeitsdaten all jener Services und Hosts für die Sie als Kontaktperson definiert sind.

Alert Histogram CGI
Alert Histogram CGI
File Name: histogram.cgi

Beschreibung:
Dieses CGI erzeugt einen Bericht über die Verfügbarkeit von Hosts und Services über einen vom Benutzer definierten Zeitraum. In Abhängigkeit davon wie häufig dieses Skript genutzt wird, sollten Sie Log Rotation aktivieren und archivierte Logs im über die log_archive_path Anweisung angegebenen Pfad aufbewahren. Das CGI verwendet Thomas Boutell's gd Library (Version 1.6.3 oder höher) um die Histogramme anzufertigen. Lesen Sie diese FAQ, wenn Sie dieses CGI nicht finden können, oder wenn Sie beim Kompilieren oder beim Aufrufen dieses CGI einen Fehler erhalten.

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie auf alle Histogramme aller Hosts und aller Services zugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie die Histogramme aller Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie Zugriff auf alle Histogramme all jener Services und Hosts für die Sie als Kontaktperson definiert sind.

Alert Summary CGI
Alert Summary CGI
File Name: summary.cgi

Beschreibung:
Dieses CGI stellt einige generische Berichte über Host und Service Alarmmeldedaten zur Verfügung (Anzahl aller Alarmmeldungen, Spitzenalarmmeldeproduzenten, usw.)

Autorisierungsvoraussetzungen:

  • Sind Sie für alle Hosts autorisiert können Sie auf alle zusammengefassten Informationen aller Hosts und aller Services zugreifen.
  • Sind Sie für alle Services autorisiert dürfen Sie die zusammengefassten Informationen aller Services aufrufen.
  • Sind Sie eine autorisierte Kontaktperson haben Sie Zugriff auf alle zusammengefassten Informationen all jener Services und Hosts für die Sie als Kontaktperson definiert sind.