Icinga

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. Bisher gibt es zwei kleine Einführungen, eine für Icinga-Web bis 1.2.x, die andere ab Version 1.3.

Einführung in Icinga-Web (<= 1.2.x)

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

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

Icinga-Web Überblick

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.3. Icinga-Web Zentrale Übersicht

Icinga-Web Zentrale Übersicht

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.

  • Hosts|Services (aktiv/passiv)

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

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

Abbildung 6.4. Icinga-Web Status-Cronk

Icinga-Web Status-Cronk

Oberes Menü

Das obere Menü beherbergt generelle Informationen zu Icinga sowie ein Benutzer-, Gruppen- sowie Log-Administrierungsmenü. Rechts oben können Sie den gerade eingeloggten Benutzer bearbeiten oder sich aus Icinga-Web ausloggen.

Abbildung 6.5. Icinga-Web top menu

Icinga-Web top menu

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

    Abbildung 6.6. Icinga-Web Data-Cronks

    Icinga-Web Data-Cronks

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

    Abbildung 6.7. Icinga-Web Tactical Overview-Cronks

    Icinga-Web Tactical Overview-Cronks

  • "Misc" enthält verschiedene nützliche Cronks, wie iframe für externe Webseiten oder 1,2,3-Spaltenansichten

    Abbildung 6.8. Icinga-Web "Misc"-Cronks

    Icinga-Web "Misc"-Cronks

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.

Abbildung 6.9. Icinga-Web Live-Suche

Icinga-Web Live-Suche

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.10. Icinga-Web Log

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.11. Icinga-Web Cronk bar

Icinga-Web Cronk bar

  • Refresh

    Manuelle Aktualisierung der Anzeige

  • Settings

    (De)aktivieren der automatischen Aktualisierung

    Get this <item> by url

Abbildung 6.12. Icinga-Web Cronk bar

Icinga-Web Cronk bar

  • 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.13. Icinga-Web Host-Befehle

Icinga-Web Host-Befehle

  • Service Commands

Abbildung 6.14. Icinga-Web Service-Befehle

Icinga-Web Service-Befehle

Filters

Filter erlauben Icinga-Web eigene, angepasste Ansichten (Views) die auch in eigenen persistenten Cronks gespeichert werden können. Als erstes wählen Sie bitte "Filter" und "Modify". Fügen Sie eine Restriktion aus dem Dropdown-Menü hinzu (dies ist von Cronk zu Cronk unterschiedlich). Wiederholen Sie diesen Schritt, um verschiedene Restriktionen zu setzen.

Abbildung 6.15. Icinga-Web Filter restriction

Icinga-Web Filter restriction

Anschließend spezifizieren Sie die Bedingung(en), unter welchen der Filter die Anzeige generieren soll (contain, does not contain, is, is not). Fügen Sie zu jeder Bedingung einen Wert hinzu; Vorschläge werden eingeblendet, sobald Sie tippen.

Abbildung 6.16. Icinga-Web filter condition

Icinga-Web filter condition

Wenden Sie den Filter auf den aktuellen Cronk an. Sofern benötigt, können Sie den Filter später modifizieren und weitere Restriktionen und Bedingungen hinzufügen/entfernen. Ein aktiver Filter wird rot markiert.

Abbildung 6.17. Icinga-Web filter active

Icinga-Web filter active

Administration

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

Abbildung 6.18. Icinga-Web top menu admin

Icinga-Web top menu admin

Benutzer

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

Abbildung 6.19. Icinga-Web user admin

Icinga-Web user admin

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össe 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.20. Icinga-Web edit user

Icinga-Web edit user

Gruppen

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

Abbildung 6.21. Icinga-Web group admin

Icinga-Web group admin

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.

  • General information + Permissions (welche Benutzer gehören zu dieser Gruppe)

  • Principals für spezielle Rollen

Abbildung 6.22. Icinga-Web groups

Icinga-Web groups

Principals

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

Abbildung 6.23. Icinga-Web principals

Icinga-Web principals

Logs

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

Abbildung 6.24. Icinga-Web logs

Icinga-Web logs

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.

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.25. Icinga-Web Login-Bildschirm

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.26. Icinga-Web Überblick

Icinga-Web Überblick

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.27. Icinga-Web Zentrale Übersicht

Icinga-Web Zentrale Übersicht

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.

  • Hosts|Services (aktiv/passiv)

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

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

Abbildung 6.28. Icinga-Web Status-Cronk

Icinga-Web Status-Cronk

Oberes Menü

Das obere Menü beherbergt generelle Informationen zu Icinga sowie ein Benutzer-, Gruppen- sowie Log-Administrierungsmenü. Rechts oben können Sie den gerade eingeloggten Benutzer bearbeiten oder sich aus Icinga-Web ausloggen.

Abbildung 6.29. Icinga-Web top menu

Icinga-Web top menu

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

    Abbildung 6.30. Icinga-Web Data-Cronks

    Icinga-Web Data-Cronks

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

    Abbildung 6.31. Icinga-Web Tactical Overview-Cronks

    Icinga-Web Tactical Overview-Cronks

  • "Misc" enthält verschiedene nützliche Cronks, wie iframe für externe Webseiten oder 1,2,3-Spaltenansichten

    Abbildung 6.32. Icinga-Web "Misc"-Cronks

    Icinga-Web "Misc"-Cronks

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.

Abbildung 6.33. Icinga-Web Live-Suche

Icinga-Web Live-Suche

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.34. Icinga-Web Log

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.35. Icinga-Web Cronk bar

Icinga-Web Cronk bar

  • Refresh

    Manuelle Aktualisierung der Anzeige

  • Settings

    (De)aktivieren der automatischen Aktualisierung

    Get this <item> by url

Abbildung 6.36. Icinga-Web Cronk bar

Icinga-Web Cronk bar

  • 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.37. Icinga-Web Host-Befehle

Icinga-Web Host-Befehle

  • Service Commands

Abbildung 6.38. Icinga-Web Service-Befehle

Icinga-Web Service-Befehle

Filters

Filter erlauben Icinga-Web eigene, angepasste Ansichten (Views) die auch in eigenen persistenten Cronks gespeichert werden können. Als erstes wählen Sie bitte "Filter" und "Modify". Fügen Sie eine Restriktion aus dem Dropdown-Menü hinzu (dies ist von Cronk zu Cronk unterschiedlich). Wiederholen Sie diesen Schritt, um verschiedene Restriktionen zu setzen.

Abbildung 6.39. Icinga-Web Filter restriction

Icinga-Web Filter restriction

Anschließend spezifizieren Sie die Bedingung(en), unter welchen der Filter die Anzeige generieren soll (contain, does not contain, is, is not). Fügen Sie zu jeder Bedingung einen Wert hinzu; Vorschläge werden eingeblendet, sobald Sie tippen.

Abbildung 6.40. Icinga-Web filter condition

Icinga-Web filter condition

Wenden Sie den Filter auf den aktuellen Cronk an. Sofern benötigt, können Sie den Filter später modifizieren und weitere Restriktionen und Bedingungen hinzufügen/entfernen. Ein aktiver Filter wird rot markiert.

Abbildung 6.41. Icinga-Web filter active

Icinga-Web filter active

Administration

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

Abbildung 6.42. Icinga-Web top menu admin

Icinga-Web top menu admin

Benutzer

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

Abbildung 6.43. Icinga-Web user admin

Icinga-Web user admin

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össe 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.44. Icinga-Web edit user

Icinga-Web edit user

Gruppen

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

Abbildung 6.45. Icinga-Web group admin

Icinga-Web group admin

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.

  • General information + Permissions (welche Benutzer gehören zu dieser Gruppe)

  • Principals für spezielle Rollen

Abbildung 6.46. Icinga-Web groups

Icinga-Web groups

Principals

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

Abbildung 6.47. Icinga-Web principals

Icinga-Web principals

Logs

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

Abbildung 6.48. Icinga-Web logs

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.49. Icinga-Web Tasks

Icinga-Web Tasks