6.1. Icinga Classic UI: Informationen über die CGIs
Zurück | Kapitel 6. Die Benutzeroberflächen | Weiter

## 6.1. Icinga Classic UI: Informationen über die CGIs

Einführung in das Icinga Classic UI

Die verschiedenen mit dem Icinga Core 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.

Die CGIs können über verschiedene Parameter gesteuert werden. Mehr Informationen finden Sie hier.

Index

Status CGI

Status map CGI

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

Änderungen am Classic UI

Status CGI

Dateiname: status.cgi

Beschreibung:

Dies ist das wichtigste mit Icinga 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

Dateiname: statusmap.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
Anmerkung: Benutzer, die nicht autorisiert sind, bestimmte Hosts zu sehen, werden unbekannte Knoten an diesen Stellen sehen. Uns 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

Dateiname: tac.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

Dateiname: 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

Dateiname: config.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

Dateiname: cmd.cgi

Beschreibung:

Dieses CGI erlaubt es Ihnen, Befehle an den Icinga-Prozess zu senden. Obwohl dieses CGI mehrere Argumente hat, sollten Sie besser darauf verzichten. Die meisten wechseln zwischen verschiedenen Revisionen von Icinga. 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 Icinga-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.

Anmerkungen:

- 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. Wir würden empfehlen, dieses CGI komplett zu entfernen, wenn Sie die Authentifizierung für CGI nicht nutzen.

Extended Information CGI

Dateiname: extinfo.cgi

Beschreibung:

Dieses CGI erlaubt es Ihnen, Icinga-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 Icinga zu erteilen. Obwohl dieses CGI mehrere Argumente hat, sollten Sie besser darauf verzichten. Die meisten wechseln zwischen verschiedenen Revisionen von Icinga. 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 Icinga-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

Dateiname: showlog.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

Dateiname: 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

Dateiname: 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

Dateiname: 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

Dateiname: avail.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

Dateiname: 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

Dateiname: 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.

Änderungen am Classic UI

Diese Änderungen sind im Laufe der Zeit eingeflossen, so dass sie ggf. nicht in Ihrer Version von Icinga verfügbar sind.

- Das Aussehen des "General"-Abschnitts auf der linke Seite hat sich erneut geändert

  General CGI

  File Name: | general.cgi

  Beim Klick auf die entsprechende Flagge können Sie weiterhin auf die Dokumentation in der dargestellten Sprache zugreifen.

  | Anmerkung
  Es gibt keine Option, um die Sprache im Classic UI zu ändern. Dafür sind Anpassungen im Source-Code notwendig.

  Nun können Sie wieder nach Hosts suchen, ohne weitere Dinge anzuklicken.

- Das klassische Interface wird in regelmäßigen Intervallen aktualisiert. Manchmal ist das nicht erwünscht, z.B. wenn Sie ein bestimmtes Objekt betrachten möchten. In diesem Fall können Sie die automatische Aktualisierung durch Klicken auf [pause] deaktivieren (direkt neben dem Text "Updated every 90 seconds" links oben im Status-Fenster). Klicken auf [continue] aktiviert die Aktualisierung wieder.

  Pause CGI

  File Name: | pause.cgi

  Continue CGI

  File Name: | continue.cgi

- Die Seiten "Host Detail" und "Service Detail" wurden erweitert, so dass Sie nun Befehle für mehrere Objekte gleichzeitig erteilen können (ab Icinga 1.2). Nun können Sie ein oder mehrere Objekte durch Check-Boxen neben den Objekten auswählen. Durch aktivieren der Check-Box neben "Status information" werden alle Services eines Hosts ausgewählt.

  Statusinfo CGI

  File Name: | statusinfo.cgi

  Commands CGI

  File Name: | commands.cgi

  Nach dem Klick auf "Select command" zeigt eine Drop-Down-Liste die verfügbaren Befehle. Nach der Auswahl einer Aktion und dem anschließenden Klick auf "Submit" wird der Befehl für die ausgewählten Objekte ausgeführt.

- "Export to CSV" wurde auf verschiedenen Seiten hinzugefügt (ab Icinga 1.2).

- Die Zellen der Tabelle in extinfo.cgi haben Namen bekommen. Mit Hilfe von SSI-Fragmenten können Sie JavaScript-Code einbinden, um auf die Daten dieser Zellen zuzugreifen (ab Icinga 1.2.1).

  Der Beispiel-Code benutzt Daten der Zelle "comment_data", um einen Link zu erzeugen (Dank an Oliver Graf).

  common-header.ssi:

      <script type='text/javascript'>
      function urlify() {
          var comments=document.getElementsByName('comment_data');
          var neu="";
          for (i=0; i<=comments.length; i++) {
              comments[i].innerHTML = comments[i].innerHTML.replace(/\bRT#(\d+)\b/g,"<a href='https://YOUR-SERVER/Ticket/Display.html?id=$1'>RT#$1</a>");
          }
      }
      window.onload=urlify;
      </script>

Zurück | Nach oben | Weiter
Kapitel 6. Die Benutzeroberflächen | Zum Anfang | 6.2. Informationen zu den CGI-Parametern

© 2009-2013 Icinga Development Team, http://www.icinga.org