Einführung
Die verschiedenen mit Nagios gelieferten CGIs werden hier beschrieben, zusammen mit den Autorisierungsanforderungen für den Zugriff und den Gebrauch jedes CGIs. Im Grundzustand erwarten die CGIs, dass Sie sich dem Web-Server gegenüber authentifiziert haben und autorisiert sind, jede Information zu sehen, die Sie anfordern. Mehr Informationen über die Konfiguration der Autorisierung finden Sie hier.
Index
- 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
Beschreibung:
Dies ist das wichtigste mit Nagios gelieferte CGI. Es erlaubt Ihnen den aktuellen Status aller überwachten Hosts und
Services zu sehen. Das Status-CGI kann zwei Arten von Ausgaben liefern - einen Status-Überblick aller Hostgruppen (oder
einer bestimmten Hostgruppe) und eine detaillierte Anzeige aller Services (oder diese bezogen auf einen bestimmten Host).
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie alle Hosts und Services ansehen, deren Kontakt Sie sind.
Status map CGI
Beschreibung:
Dieses CGI erstellt eine Karte aller Hosts, die Sie in Ihrem Netzwerk definiert haben. Das CGI nutzt Thomas Boutells
gd-Library (Version 1.6.3 oder höher), um ein PNG-Bild Ihrer Netzwerk-Struktur
zu erstellen. Die verwendeten Koordinaten (zusammen mit den optionalen Icons) werden aus den Host-Definitionen genommen.
Wenn Sie es vorziehen, dass das CGI automatisch für Sie Koordinaten generiert, nutzen Sie die
default_statusmap_layout-Direktive, um einen Layout-Algorithmus zu definieren.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie alle Hosts und alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie alle Services ansehen, deren Kontakt Sie sind.
Anmerkung: Benutzer, die nicht autorisiert sind, bestimmte Hosts zu sehen, werden unbekannte Knoten an diesen Stellen sehen. Mir ist klar, dass sie eigentlich überhaupt nichts dort sehen sollten, aber es ist nicht sinnvoll, eine Karte zu generieren, wenn man nicht die ganzen Host-Abhängigkeiten sehen kann.
WAP interface CGI
Beschreibung:
Dieses CGI dient als WAP-Interface für Netzwerk-Status-Informationen. Wenn Sie ein Gerät mit WAP-Unterstützung haben
(z.B. ein Internet-fähiges Handy), können Sie Statusinformationen ansehen, während Sie unterwegs sind.
Verschiedene Status-Anzeigen enthalten Hostgruppen-Zusammenfassung, Hostgruppen-Übersicht, Host-Details, Service-Details,
alle Probleme und alle unbehandelten Probleme. Zusätzlich zur Ansicht von Statusinformationen können Sie mit Ihrem
Handy auch Benachrichtigungen und Prüfungen deaktivieren und Probleme bestätigen. Ziemlich cool, oder?
Autorisierungsanforderungen:
- Wenn Sie für Systeminformationen autorisiert sind, können Sie Nagios-Prozess-Informationen ansehen.
- Wenn Sie für alle Hosts autorisiert sind, können Sie Zustandsdaten für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Zustandsdaten für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Zustandsdaten für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Status world CGI (VRML)
Beschreibung:
Dieses CGI erstellt ein 3-D VRML-Modell aller Hosts, die in Ihrem Netzwerk definiert sind. Die verwendeten Koordination (sowie
schöne Textur-Karten) werden aus den Host-Definitionen genommen.
Wenn Sie es vorziehen, dass das CGI automatisch für Sie Koordinaten generiert, nutzen Sie die
default_statuswrl_layout-Direktive, um einen Layout-Algorithmus zu definieren.
Sie benötigen einen VRML-Browser (wie Cortona, Cosmo Player oder WorldView)
auf Ihrem System, bevor Sie das generierte Modell betrachten können.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie alle Hosts ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie alle Hosts ansehen, deren Kontakt Sie sind.
Anmerkung: Benutzer, die nicht autorisiert sind, bestimmte Hosts zu sehen, werden unbekannte Knoten an diesen Stellen sehen. Mir ist klar, dass sie eigentlich überhaupt nichts dort sehen sollten, aber es ist nicht sinnvoll, eine Karte zu generieren, wenn man nicht die ganzen Host-Abhängigkeiten sehen kann.
Tactical overview CGI
Beschreibung:
Dieses CGI dient als Sicht aus der "Vogelperspektive" auf alle Netzwerk-Überwachungs-Aktivitäten. Es erlaubt Ihnen
schnell Netzwerkausfälle sowie Host- und Service-Zustände zu erkennen. Es unterscheidet zwischen Problemen, die
auf irgendeine Weise "behandelt" wurden (z.B. bestätigt oder Benachrichtigungen deaktiviert) und solchen, die nicht
behandelt wurden und die deshalb Beachtung erfordern. Das ist sehr hilfreich, wenn Sie viele zu überwachende Hosts und
Services haben und einen einzelnen Bildschirm zur Alarmierung über Probleme einsetzen möchten.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie alle Hosts und Services ansehen, deren Kontakt Sie sind.
Network outages CGI
Beschreibung:
Dieses CGI zeigt eine Liste von "Problem"-Hosts, die Netzwerkausfälle hervorrufen. Dies kann besonders dann hilfreich
sein, wenn Sie ein großes Netzwerk haben und schnell die Quelle des Problems identifizieren möchten. Hosts werden
sortiert nach der Schwere des Ausfalls, den sie bewirken.
- Wenn Sie für alle Hosts autorisiert sind, können Sie alle Hosts ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie alle Hosts ansehen, deren Kontakt Sie sind.
Configuration CGI
Beschreibung:
Dieses CGI erlaubt es Ihnen, Objekte (z.B. Hosts, Hostgruppen, Kontakte, Kontaktgruppen, Zeitfenster, Services, etc.) anzusehen,
die Sie in Ihrer/Ihren Objekt-Konfigurationsdatei(en) definiert haben.
Autorisierungsanforderungen:
- Sie müssen für Konfigurationsinformationen autorisiert sein, um jegliche Konfigurationsinformationen ansehen zu können.
Command CGI
Beschreibung:
Dieses CGI erlaubt es Ihnen, Befehle an den Nagios-Prozess zu senden. Obwohl dieses CGI mehrere Argumente hat, sollten Sie
besser darauf verzichten. Die meisten wechseln zwischen verschiedenen Revisionen von Nagios. Nutzen Sie das
extended information CGI als Startpunkt, um Befehle zu erteilen.
Autorisierungsanforderungen:
- Sie müssen für System-Befehle autorisiert sein, um Befehle zu erteilen, die den Nagios-Prozess beeinflussen (Start, Stop, Modus-Wechsel, etc.).
- Wenn Sie für alle Hosts-Befehle autorisiert sind, können Sie Befehle für alle Hosts und alle Services erteilen.
- Wenn Sie für alle Service-Befehle autorisiert sind, können Sie Befehle für alle Services erteilen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Befehle für alle Hosts und Services erteilen, deren Kontakt Sie sind.
- Wenn Sie sich entschieden haben, die Option use_authentication für die CGIs nicht zu nutzen, wird dieses CGI jedem die Möglichkeit verweigern, Befehle zu erteilen. Dies geschieht zu Ihrem eigenen Schutz. Ich würde empfehlen, dieses CGI komplett zu entfernen, wenn Sie die Authentifizierung für CGI nicht nutzen.
Extended information CGI
Beschreibung:
Dieses CGI erlaubt es Ihnen, Nagios-Prozess-Informationen, Host- und Service-Zustandsstatistiken, Host- und Service-Kommentare
und mehr anzusehen. Es dient auch als Startpunkt, um über das command CGI Befehle an Nagios zu
erteilen. Obwohl dieses CGI mehrere Argumente hat, sollten Sie besser darauf verzichten. Die meisten wechseln zwischen
verschiedenen Revisionen von Nagios. Sie können dieses CGI erreichen, indem Sie auf 'Network Health' bzw. 'Process Information'
in der setilichen Navigationsleiste klicken oder auf einen Host- oder Service-Link in der Ausgabe des status CGI.
Autorisierungsanforderungen:
- Sie müssen für Systeminformationen autorisiert sein, um Nagios-Prozess-Informationen ansehen zu können.
- Wenn Sie für lle Hosts autorisiert sind, können Sie erweiterte Informationen für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie erweiterte Informationen für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie erweiterte Informationen für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Event log CGI
Beschreibung:
Dieses CGI zeigt das log file. Wenn Sie die log rotation
aktiviert haben, können Sie in archivierten Log-Dateien blättern, indem Sie die Navigations-Links oben auf der
Seite benutzen.
Autorisierungsanforderungen:
- Sie müssen für Systeminformationen autorisiert sein, um das Logfile ansehen zu können.
Alert history CGI
Beschreibung:
Dieses CGI wird benutzt, um die Problem-Historie für einen oder alle Hosts anzuzeigen. Die Ausgabe ist grundsätzlich
ein Auszug der Informationen, die über das log file CGI angezeigt werden.
Sie haben die Möglichkeit, die Ausgabe zu filtern, um nur die Problemtypen anzuzeigen, die Sie sehen wollen
(z.B. Hard- und/oder Soft-Alarme, verschiedene Typen von Service- und Host-Alarmen, alle Arten von Alarmen, usw.).
Wenn Sie die log rotation aktiviert haben, können Sie in archivierten
Log-Dateien blättern, indem Sie die Navigations-Links oben auf der Seite benutzen.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie historische Informationen für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie historische Informationen für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie historische Informationen für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Notifications CGI
Beschreibung:
Dieses CGI wird genutzt, um Host- und Service-Benachrichtigungen anzuzeigen, die an verschiedene Kontakte versandt wurden.
Die Ausgabe ist grundsätzlich ein Auszug der Informationen, die über das log file CGI
angezeigt werden.
Sie haben die Möglichkeit, die Ausgabe zu filtern, um nur die Benachrichtigungen anzuzeigen, die Sie sehen wollen
(z.B. Service-Benachrichtigungen, Host-Benachrichtigungen, Benachrichtigungen, die an bestimmte Kontakte versandt wurden, usw.).
Wenn Sie die log rotation
aktiviert haben, können Sie in archivierten Log-Dateien blättern, indem Sie die Navigations-Links oben auf der
Seite benutzen.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie Benachrichtigungen für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Benachrichtigungen für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Benachrichtigungen für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Trends CGI
Beschreibung:
Dieses CGI wird genutzt, um einen Graphen über Host- oder Service-Zustände für einen beliebigen Zeitraum
zu erstellen. Damit dieses CGI von Wert ist, sollten Sie log rotation aktivieren
und archivierte Logs in dem Verzeichnis lagern, das durch die log_archive_path-Direktive
angegeben wird. Das CGI nutzt Thomas Boutells gd-Library (Version 1.6.3 oder höher),
um die Trend-Grafiken zu erstellen.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie Trends für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Trends für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Trends für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Availability reporting CGI
Beschreibung:
Dieses CGI wird genutzt, um einen Bericht über die Verfügbarkeit von Hosts oder Service für einen benutzerdefinierten Zeitraum
zu erstellen. Damit dieses CGI von Wert ist, sollten Sie log rotation aktivieren
und archivierte Logs in dem Verzeichnis lagern, das durch die log_archive_path-Direktive
angegeben wird.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie Verfügbarkeitsdaten für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Verfügbarkeitsdaten für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Verfügbarkeitsdaten für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Alert histogram CGI
Beschreibung:
Dieses CGI wird genutzt, um einen Bericht über die Verfügbarkeit von Hosts oder Service für einen benutzerdefinierten Zeitraum
zu erstellen. Damit dieses CGI von Wert ist, sollten Sie log rotation aktivieren
und archivierte Logs in dem Verzeichnis lagern, das durch die log_archive_path-Direktive
angegeben wird.
Das CGI nutzt Thomas Boutells gd-Library (Version 1.6.3 oder höher),
um die Histogramm-Grafiken zu erstellen.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie Histogramme für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Histogramme für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Histogramme für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Alert summary CGI
Beschreibung:
Dieses CGI stellt einige generische Berichte über Host- und Service-Alarmdaten zur Verfügung, darunter Gesamtzahl Alarme,
Alarm-Spitzenreiter, etc.
Autorisierungsanforderungen:
- Wenn Sie für alle Hosts autorisiert sind, können Sie Summary-Informationen für alle Hosts und alle Services ansehen.
- Wenn Sie für alle Services autorisiert sind, können Sie Summary-Informationen für alle Services ansehen.
- Wenn Sie ein authentifizierter Kontakt sind, können Sie Summary-Informationen für alle Hosts und Services ansehen, deren Kontakt Sie sind.
Siehe auch: Optionen der CGI-Konfigurationsdatei, Authentifizierung und Autorisierung in den CGIs, CGI-Fuß- und Kopfzeilen