6.7. Einführung in Icinga-Web
Zurück | Kapitel 6. Die Benutzeroberflächen | Weiter

## 6.7. Einführung in Icinga-Web

Überblick

Diese Einführung wird Sie auf eine kurze Tour einladen, um diverse Aspekte von Icinga-Web zu skizzieren. Es besteht kein Anspruch auf Vollständigkeit, da dieses Dokument stetig erweitert wird.

Bedingt durch ständige Weiterentwicklung ändern sich einige Dinge mit der Zeit und Optionen werden hinzugefügt. Bitte werfen Sie einen Blick auf die aktuelle Version 1.9.

### 6.7.1. Einführung in Icinga-Web (>= 1.9)

Wenn Sie den Schnellstart-Anleitungen (IDOUtils und Icinga-Web) gefolgt sind, sollten Sie nun http://<icinga server>/icinga-web aufrufen können und den Login-Bildschirm sehen

Abbildung 6.1. Icinga-Web Login-Bildschirm

Sie können sich mittels "root" und "password" einloggen. Dies wird Sie auf eine Überblickseite weiterleiten, wo der Status von überwachten Hosts und Services dargestellt wird.

Abbildung 6.2. Icinga-Web Überblick

Oberes Menü

Das obere Menü beherbergt generelle Informationen zu Icinga sowie ein Benutzer-, Gruppen-, Log- sowie Task-Administrierungsmenü. Die Live-Such öffnet sich, wenn Sie auf das Vergrößerungsglas neben der Uhrzeit klicken. Rechts oben können Sie den gerade eingeloggten Benutzer bearbeiten oder sich aus Icinga-Web ausloggen.

Abbildung 6.3. Icinga-Web Top-Menü

Suche

Die Suche zeigt live Resultate, während Sie tippen. Diese werden in einem eigenen Inlay-Fenster angezeigt. Indem Sie ein Ergebnis anklicken, wird ein neuer Tab mit näheren Informationen geöffnet. Die Suche beginnt am Anfang der Zeichenkette, aber Sie können auch Wildcards benutzen.

Abbildung 6.4. Icinga-Web Live-Suche

Status-Cronk

Der Status-Cronk zeigt die aktuelle Anzahl von Hosts und Services aufgeteilt nach ihren aktuellen Zuständen. Sofern ein Zähler Null (0) ist, wird dieser grau hinterlegt angezeigt. Klicken Sie auf einen Zustand, um einen neuen Tab zu öffnen, der nur den gewählten Zustand anzeigt. Daneben finden Sie die Anzahl und den Zustand der Icinga-Instanzen. Der verbleibende Platz wird für die Anzeige allgemeiner Informationen benutzt, das sind:

- Hosts|Services (aktiv/passiv)

- Host|Service Ausführungszeit (min/avg/max)

- Host|Services Latenzzeit (min/avg/max)

Abbildung 6.5. Icinga-Web Status-Cronk

Linkes Menü

Im linken (versteckbaren) Menü können Sie aus verschiedenen Widgets (wir nennen diese "Cronks") auswählen, die das Arbeiten mit Icinga-Web erleichtern werden. Sie können entweder einen Cronk doppelklicken oder diesen mit dem Mauszeiger in die zentrale Tab-Leiste ziehen. Die Kategorien sind wie folgt aufgeteilt:

- "Data", um Status-, historische und Konfigurationsdaten zu erhalten. In Icinga 1.6 gibt es zwei neue Cronks: eins für Informationen über Instanzen und eins für die "Tackle View"

  Abbildung 6.6. Icinga-Web Data-Cronks

- "Tactical Overview" bietet generelle Charts und eigene angepasste an (Custom Variables)

  Abbildung 6.7. Icinga-Web Tactical Overview-Cronks

- "Reporting" bietet Auswertungen

  Abbildung 6.8. Icinga-Web Reporting-Cronks

- "Misc" enthält verschiedene nützliche Cronks, wie iframe für externe Webseiten oder 1,2,3-Spaltenansichten sowie Links auf die englische bzw. deutsche Dokumentation

  Abbildung 6.9. Icinga-Web "Misc"-Cronks

Sie können im Settings-Menü auch zur alten Ansicht mit den größeren Icons wechseln. In der Konfigurationsdatei `userpreferences.xml` können Sie einen globalen Defaultwert setzen.

Abbildung 6.10. Icinga-Web Cronk Menü Umschalter

Zentrale Übersicht

Hier findet sich alles zusammen: Sie können mittels drag-and-drop neue Fenster hereinziehen. Die Ansichten für den aktuellen Benutzer sind konfigurierbar (diese sind persistent), z.B. durch verschieben der Spaltenüberschrift an die gewünschte Stelle. Rechtsklicken auf die Spaltenüberschrift ermöglicht die Einstellung der Sortierreihenfolge oder das Verstecken von Spalten. Zu öffnende Suchresultate werden ebenfalls hier in einem neuen Tab geöffnet; das gilt auch für das Öffnen verfügbarer Cronks.

Abbildung 6.11. Icinga-Web Zentrale Übersicht

Host Status

Die HostStatus-Ansicht zeigt den Host-Status und darunter die Anzahl von Warning/Critical der zugehörigen Services. Über die erweitere Ansicht können Sie in die Servicestatus- Ansicht und die Historie des Hosts wechseln, die Statusmap ansehen sowie die Performancedaten des Hosts anzeigen lassen, sofern Sie PNP4Nagios nutzen.

Abbildung 6.12. Icinga-Web Host-Status

Host Informationen

Über Details in der erweiterten HostStatus-Ansicht sehen Sie detaillierte Host- Status Informationen, zugeordnete Kontakte und Hostgruppen und externe Referenzen.

Abbildung 6.13. Icinga-Web Objekt-Information

Service Status

Die ServiceStatus-Ansicht zeigt die Services für jeden Host.

Abbildung 6.14. Icinga-Web Service-Status

Service Informationen

Über die erweitere ServiceStatus-Ansicht können Sie detaillierte Service- Status- und Host- Status- Informationen ansehen, die Historie des Services aufrufen und in die HostStatus- Ansicht wechseln.

Abbildung 6.15. Icinga-Web Service Information

Hostgroup Status

Die Hostgroup-Ansicht zeigt den Status und die Anzahl der Hosts mit dem jeweiligen Status gruppiert nach den Hostgruppen.

Abbildung 6.16. Icinga-Web Hostgruppenstatus

Log

Am unteren Fensterrand wird das aktuelle Icinga-Protokoll eingeblendet. Das Log wird automatisch aktualisiert, und kann auch minimiert werden, um mehr Platz für die zentrale Übersicht zu schaffen.

Abbildung 6.17. Icinga-Web Log

Cronks und Views

Icinga-Web erlaubt es, mehrere Cronks für verschiedene Anwendungsgebiete zu öffnen und zu verwalten. Damit können Sie Daten einsehen, Filter für unterschiedliche Views setzen oder Kommandos absenden. Die folgende Übersicht fasst die generellen Möglichkeiten zusammen (einige Cronks bieten zusätzliche Items, wie etwas das Senden von Kommandos).

Abbildung 6.18. Icinga-Web Cronk-Leiste

- Refresh

  Manuelle Aktualisierung der Anzeige

- Settings

  (De)aktivieren der automatischen Aktualisierung

  Get this <item> by url

Abbildung 6.19. Icinga-Web Cronk-Leiste

- Filter

  Modify/Remove

Commands

In Icinga-Web gibt es verschiedene Kommandos (siehe Kapitel "External Commands" für mehr Informationen), die an den Core geschickt werden können. Selektieren Sie die Einträge, die davon betroffen sein sollen, und dann das Kommando, das ausgeführt werden soll.

Host Commands Abbildung 6.20. Icinga-Web Host-Befehle | Service Commands Abbildung 6.21. Icinga-Web Service-Befehle

Filter

Filter erlauben Icinga-Web eigene, angepasste Ansichten (Views) die auch in eigenen persistenten Cronks gespeichert werden können. Als erstes wählen Sie bitte "View Filter". Auf der linken Seite öffnet sich an Stelle des Cronk Menüs die Auswahl der Filterattribute und -bedingungen im unteren Bereich, sowie die Anzeige des aktuellen Filters im oberen Bereich.

Abbildung 6.22. Icinga-Web Filtereinschränkung

Anschließend spezifizieren Sie die Bedingung(en), unter welchen der Filter die Anzeige generieren soll, indem Sie Filterattribute und -bedingung mittels Drag and Drop verschieben.

drag filter Abbildung 6.23. Icinga-Web drag filter | drop filter Abbildung 6.24. Icinga-Web drop filter

Sobald Sie den Attributfilter auf eine Bedingung gezogen haben, können Sie dessen Werte einstellen (abhängig vom Attribut. Das Beispiel zeigt lediglich jene Auswahl des Status an). Klicken Sie "Add filter" an sobald Sie fertig sind.

Abbildung 6.25. Icinga-Web Filter Attribut Selektierung

Der aktive Filter zeigt nun nur die gefilterte Ansicht und dessen Einträge.

Abbildung 6.26. Icinga-Web Filter aktiv

Sie können auch mehrere Filter (auch desselben Typs) durch Bedingungen miteinander verknüpfen. DAs Beispiel zeigt eine Oder-Verknüpfung zwischen dem Status Critical und Warning.

Abbildung 6.27. Icinga-Web filter advanced filters

Administration

Steigen Sie in die Administrationsübersicht ein, indem Sie "Admin" im oberen Menü auswählen. Danach wählen Sie "Users", "Groups", "Logs" oder "Tasks".

Abbildung 6.28. Icinga-Web Top-Menü Admin

Benutzer

Sie können Benutzer hinzufügen, löschen oder editieren. Sie können auch Benutzer suchen.

Abbildung 6.29. Icinga-Web Benutzer-Administration

Doppelklicken Sie einen Benutzer um ein neues Inlay Fenster zu öffnen, das Ihnen erlaubt, weitere Details zu spezifizieren. Dieselben Optionen stehen zur Verfügung, wenn Sie einen neuen Benutzer anlegen. Sie können die Größe des Fensters mittels Mauszeigerbewegung an den Ecken beeinflussen.

- General information

- Change password (and optional AuthKey for API)

- Permissions; z.B. zu welcher Gruppen zugehörig

- Principals für spezielle Rollen

Abbildung 6.30. Icinga-Web Benutzer editieren

Gruppen

Sie können Gruppen hinzufügen, löschen oder editieren. Die Gruppenvererbung lässt sich direkt im Gruppenbaum auf der rechten Seite anpassen. Sie können auch nach Gruppen suchen.

Abbildung 6.31. Icinga-Web Gruppen-Administration

Doppelklicken Sie eine Gruppe, um ein neues Inlay-Fenster zu öffnen, das Ihnen erlaubt, weitere Details zu spezifizieren. Dieselben Optionen stehen zur Verfügung, wenn Sie eine neue Gruppe anlegen. Sie können die Größe des Fensters mittels Mauszeigerbewegung an den Ecken beeinflussen.

Abbildung 6.32. Icinga-Web Gruppen

Rollen

In der Benutzer- und Gruppenübersicht im Administrationsbereich können Sie Rollen hinzufügen/entfernen/editieren. Nachfolgend eine Liste der verfügbaren Rollen:

Abbildung 6.33. Icinga-Web Rollen

| Anmerkung
Weitere Informationen zum Berechtigungskonzept von Icinga-Web finden Sie im Wiki.

Logs

Hier können Sie verschiedene Logs betrachten, um diese als Hilfe bei Ihrer Fehlersuche zu verwenden.

Abbildung 6.34. Icinga-Web logs

Task

Verschiedene Dinge erfordern das Löschen des Cache. Anstatt auf die Kommandozeile zu wechseln können Sie den Befehl über das "Tasks"-Menü ausführen.

Abbildung 6.35. Icinga-Web Tasks

Zurück | Nach oben | Weiter
6.6. Aktualisierung von Icinga-Web und Icinga-Web Datenbank | Zum Anfang | 6.8. Integration von PNP4Nagios in das Icinga-Web Frontend

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