Dashboards

Dashboards sind in Checkmk die zentralen Ansichten für Ihr Monitoring. Sie liefern Ihnen sowohl Übersichten als auch detaillierte Einsichten in bestimmte Bereiche. Sie können etwa den allgemeinen Status ganzer Netzwerksegmente visualisieren, aber auch schlicht auflisten, welche Services just für eine Aus- oder Überlastung bestimmter Systemressourcen sorgen. Checkmk bringt einige Standard-Dashboards mit sich, so für Probleme, Checkmk-Server-Statistiken und natürlich einen Gesamtüberblick. Sie dürfen aber völlig individuelle Dashboards von Grund auf selbst gestalten.

Welche Werkzeuge dafür zur Verfügung stehen und wie genau Sie damit eigene Übersichten aufbauen, lesen Sie in diesem Artikel. Zunächst zeigen wir Ihnen, wie Dashboards grundsätzlich funktionieren und wie Sie damit arbeiten. Anschließend beleuchten wir die Grundlagen für Layout und Konfiguration, um darauf aufbauend ein komplettes, einfaches Beispiel-Dashboard Schritt für Schritt zu kreieren. Weiter geht es mit der Vorstellung aller bereits eingebauten Dashboards und Widgets — den einzelnen Bausteinen für Übersichten. Den Abschluss bilden Tipps zum Umgang mit Fehlern und Problemen.

Das auffälligste Dashboard sehen Sie übrigens direkt auf der Startseite von Checkmk, allerdings können Dashboards wie sonstige Ansichten behandelt und ganz einfach über die Navigationsleiste und die Seitenleiste aufgerufen werden.

Und natürlich eignen sich Dashboards bestens, um sie separat auf einzelne Monitore zu legen, sei es für einen großen Leitstand, als Info-Display für Server-Räume oder als schlichtes Kiosk-Display für den Konferenzsaal.

Das Besondere an Checkmk-Dashboards ist unser hauseigenes Anchored Layout: Über einen intelligenten Algorithmus passen sich Dashboards automatisch an die Dimensionen des Displays beziehungsweise des Browserfensters an. Dabei können Sie für alle einzelnen Elemente des Dashboards, die Widgets, festlegen, wie genau sie sich verhalten und in welche Richtungen sie sich bei Bedarf ausdehnen.

Seit Version 2.5.0 gibt es in den kommerziellen Editionen zudem ein alternatives Responsive Layout: Hier gestalten Sie Ihr Layout einfach per Drag&Drop, die Anpassung an unterschiedliche Displays geschieht automatisch.

Eine Gegenüberstellung der beiden Systeme und nähere Details lesen Sie im Kapitel Layout.

Für den Inhalt stehen Widgets unterschiedlicher Kategorien zur Verfügung: Reguläre Ansichten, Graphen, Metriken, vorgefertigte Elemente für diverse Statistiken und Zeitleisten sowie Kästen für statische Texte und beliebige URLs. Eine Übersicht aller Widgets finden Sie weiter unten.

Einige der Widgets gibt es exklusiv in den kommerziellen Editionen.

Ein wichtiges Feature bei der Dashboard-Nutzung: Über Filter können selbst Dashboards, die Werte für alle Hosts oder Services im Netzwerk anzeigen, auf bestimmte Bereiche heruntergebrochen werden. Dashboards sind also nicht bloß starre Anzeigen, sondern echte Werkzeuge zum Auffinden und Analysieren von Problemen und Zuständen.

Dieses Layout-System ist vollkommen intuitiv: Sie platzieren Widgets per Drag&Drop und skalieren über den Anfasser in der rechten, unteren Ecke. Hier ein Beispiel, der Einfachheit halber mit acht Versionen desselben Site overview-Widgets:

Wenn dieses Dashboard nun zum Beispiel auf einem mobilen Gerät landet oder man schlicht, wie hier zur Demonstration, das Browserfenster etwas schmaler zieht, passen sich Anordnung und Skalierung der Widgets an:

Der große Vorteil: Alles geschieht ganz automatisch. Der Preis dafür: Wenn Sie ein bestimmtes Widget, beispielsweise einen Graph mit Zeitleiste, immer über die volle Breite anzeigen lassen wollen, ist das mit diesem System nicht möglich.

Das Prinzip ist simpel: Eine beliebige Ecke eines Widgets wird als Anker festgelegt. Von diesem Fixpunkt aus kann das Widget dann in Höhe und/oder Breite wachsen, sobald mehr Platz zur Verfügung steht, also zum Beispiel schlicht auf einem größeren Bildschirm, aber auch, wenn sich die Position oder Größe anderer Widgets verändert.

Zur Verdeutlichung hier ein Beispiel mit dem bereits bekannten Site overview-Widget — in der Mitte mit manueller Höhe und Breite sowie dem Anker oben links. Den Anker erkennen Sie an der grünen Ecke, die Einstellungen für aktuelle Höhe und Breite finden Sie in der Mitte der Widgets.

Umrahmt wird es von vier weiteren Widgets, allesamt mit automatischer Höhe, die seitlichen auch mit automatischer Breite — die Widgets oben und unten bekommen die Einstellung Max width. Standardmäßig sitzt der Anker oben links, hier bekommt jedoch das rechte Widget den Anker oben rechts und das untere unten links.

Wenn man nun das mittige Widget zum Beispiel weiter nach links und unten verschiebt, verändern sich die Widgets links, rechts und unten — denn sie wachsen automatisch von ihren Ankern hin zum zentralen Widget.

Das obere Widget hingegen bleibt, wie es ist. Nach unten kann es schließlich nicht wachsen, da die beiden seitlichen Widgets oben verankert sind.

Schaltet man nun das untere Widget von Max width auf Auto width, geht es nicht mehr über die gesamte Breite — weil die automatische Höhe des rechten Widgets vor der automatischen Breite des unteren Widgets gerendert wird (weil zeilenweise vorgegangen wird).

Wenn Widgets mit automatischen Dimensionen um denselben Raum streiten, können Sie mit der Maximaleinstellung quasi den Gewinner festlegen — aber Vorsicht: Konkurrieren zwei auf Maximum gesetzte Widgets um denselben Raum, kann es zu Überlappungen kommen.

Einfacher zu verstehen ist das ganze Anchored-Layout, wenn Sie sich solch einen Testaufbau selbst anlegen und die Widgets ein wenig herumschubsen.

Die Dashboard-Konfiguration sehen Sie automatisch beim Anlegen eines neuen Dashboards. Später erreichen Sie sie über die Symbole in der Dashboard-Liste (Customize > Visualization > Dashboards) oder den Menüeintrag Settings > Dashboard settings eines geöffneten Dashboards.

Die Eigenschaften des Dashboards an sich sind trivial. Hier werden lediglich Metadaten wie Name, Menüeintrag, Sichtbarkeit in Menüs und für Benutzer(-gruppen) gesetzt.

Die Konfiguration einzelner Widgets sehen Sie automatisch beim Hinzufügen zu einem Dashboard. Später rufen Sie sie direkt über das Zahnrad-Symbol der Widgets im Layout-Modus auf.

Übrigens: Im Responsive Layout sehen die Widgets minimal anders aus, die Symbole sind aber identisch:

Die Konfiguration der meisten Widgets ist recht simpel. Typischerweise finden Sie Data settings zur Beschränkung und Darstellung von Daten sowie Widget settings mit Optionen für Titel, Verlinkung und so weiter — hier mal am Beispiel des Gauge-Widgets.

Bei allen Widgets, die sich auf einige oder einzelne Hosts und Services beziehen, finden Sie zudem entsprechende Filtermöglichkeiten.

Eine genaue Beschreibung der Filter finden Sie im Kapitel Filter, konkrete Beispiele für Widget-Konfigurationen im Kapitel Beispiel-Dashboard.

Auch abseits der Dashboard- und Widget-Konfiguration gibt es in Checkmk wichtige Einstellungen, nämlich die Berechtigungen. Unter Setup > Users > Roles & permissions > Edit role user können Sie einfach nach dashboard filtern, um alle Optionen aufzulisten. Hier lässt sich für eine Rolle detailliert festlegen, welche Standard-Dashboards deren zugewiesene Benutzer sehen und was genau sie mit sonstigen Dashboards anfangen dürfen.

Die Filterung von Dashboards und Widgets ist ein mächtiges Feature, zu finden in mehreren Ausprägungen. Hier zunächst mal eine Übersicht:

Default filters setzen konkrete Vorgaben für das gesamte Dashboard, also beispielsweise den Filter Host name (exact match) mit dem Wert myhost.

Runtime filters in der Dashboard-Konfiguration setzen leere Vorgaben für das gesamte Dashboard, also beispielsweise den Filter Host name (exact match) — und Benutzer müssen diesen dann zur Laufzeit (letztlich also beim Anschauen des Dashboards) selbst setzen. Sind Runtime filters in der Konfiguration gesetzt, wird das Dashboard mit geöffnetem Filter-Dialog gestartet — schließlich müssen Benutzer diese Filter mit Werten füllen.

Widget filters wiederum werden pro Widget in der jeweiligen Widget-Konfiguration gesetzt. Hier wird nicht nur auf Hosts und Services, sondern bei Bedarf auch zusätzlich auf Metriken (von Services) gefiltert.

Die beiden Dashboard-Filter erreichen Sie vom Dashboard aus über Settings > Filter settings, die Widget-Filter über das Zahnrad-Symbol an Widgets selbst.

Runtime filters stehen aber auch außerhalb der Konfiguration in der regulären Dashboard-Ansicht zur Verfügung — für normale Benutzer. Diese Filter erreichen Sie über den Knopf Filter direkt neben der Dashboard-Auswahl.

Wichtig ist nun auch das Zusammenspiel dieser Filter: Widget-Filter überschreiben Runtime-Filter überschreiben Default-Filter.

Folgendes Bild illustriert das gesamte Filterspektrum für Hosts (Punkte 3 bis 5):

In diesem Dashboard ist also ein Widget vom Typ Metric vorgegeben, das immer die Metrik RAM usage des Services Memory anzeigt — standardmäßig per Default-Filter vom Host localhost, der hier aber überschrieben wird vom Runtime-Filter auf den Host myhost, der wiederum vom Widget-Filter auf den Host raspi_lan überschrieben wird.

Anders ausgedrückt: Beim Erstellen von Dashboards können Sie Dashboard-weite Vorgaben machen, die Benutzer wiederum überschreiben können (Runtime-Filter in der Ansicht) oder müssen (Runtime-Filter in der Konfiguration). Einzelne Widgets können Sie hingegen fix konfigurieren und Benutzern weitere Filter vorenthalten.

Sie haben Stunden in ein mächtiges Dashboard investiert? Es wäre doch schade, dies für sich zu behalten. Daher können Sie Dashboards auch teilen, sowohl intern wie extern.

Die zugehörige Konfiguration erreichen Sie im jeweiligen Dashboard über Share > Configure sharing.

Ein interner Link zum Dashboard ist unter Internal access standardmäßig vorhanden — und hat keinen Einfluss auf den Status, den Sie oben im Bild sehen (hier Sharing paused).

Der Status bezieht sich allein auf den öffentlichen Link unter Public access, schließlich können Dashboards durchaus kritische Informationen enthalten, die nicht unbedingt für die Öffentlichkeit gedacht sind.

Sobald Sie hier einen Link aktivieren, ändert sich der Status von Sharing disabled auf Sharing enabled. Ist der öffentliche Zugriff aktiv und Sie ändern das Dashboard, sehen Sie den Status Sharing paused. Um das Sharing fortzusetzen, müssen Sie das Dashboard erneut freigeben. Der Sharing-Link selbst ändert sich dabei nicht.

Die einzige Option beim Teilen: Sie können die Freigabe zeitlich begrenzen. In Checkmk Community sind Freigaben auf maximal 30 Tage begrenzt, in den kommerziellen Editionen ist ein Auslaufdatum komplett optional.

Geteilte, öffentliche Dashboards haben aus Sicherheitsgründen ein paar Einschränkungen: Navigation und Menüs sind versteckt, es gibt keine Filtermöglichkeiten, Seitenleistenelemente sind nicht verfügbar. Und in Listenansichten stehen möglicherweise nicht alle Einträge zur Verfügung, weil diese standardmäßig begrenzt sind und die Schaltflächen für die Entgrenzung, abermals aus Sicherheitsgründen, fehlen.

Eine Liste aller individuell angelegten sowie eingebauten Dashboards finden Sie über Customize > Visualization > Dashboards. Für die manuell angelegten Dashboards können Sie über die Eigenschaften aufrufen und über den Layout-Modus. Die werksseitig vorgegebenen Dashboards können Sie nicht direkt aus der Liste heraus bearbeiten, jedoch über klonen und dann anpassen.

Hier ein Auszug der eingebauten Dashboards:

Hier sehen Sie zunächst alle Widgets in der Übersicht. Anschließend zeigen wir Ihnen noch ein paar Besonderheiten, die im obigen Beispiel-Dashboard nicht mit abgehandelt wurden.

Wie genau Sie die Graphen in den Graphing-Widgets gestalten, ist etwas komplexer und wird im Graphing-Artikel ausführlich erläutert.

Eine besondere Rolle spielt das Widget Embed URL. Theoretisch können Sie über die simple Angabe einer Adresse externe Webseiten oder Ressourcen einbinden. In der Praxis scheitert das oft an Sicherheitsmaßnahmen der Betreiber und Browser. Freilich funktioniert das sehr wohl mit Checkmk-eigenen Ressourcen, beispielsweise anderen Dashboards. So ließen sich etwa mehrere Host-spezifische Dashboards zu einer großen Übersicht verknüpfen. Was Sie — mit ein wenig Experimentierfreude — ebenso einbinden können, sind interne Ressourcen des Checkmk-Servers; beispielsweise jegliche Art von Webanwendungen, sei es ein Wiki oder ein kleines Chat-Programm.

Das Widget Site overview hat zwei Funktionen: In den Erläuterungen zum Layout oben sehen Sie es als Übersicht der Hosts — Standard auf einer normalen, einzelnen Checkmk-Instanz. Im verteilten Monitoring zeigt dieses Widget hingegen eine Übersicht der zusammengeschlossenen Instanzen.

Ein wenig mehr, als Sie vielleicht vermuten würden, kann auch das Widget Static text: Es eignet sich für Hinweise und simple Beschriftungen, kann aber auch zum Verlinken sonstiger Dashboards oder anderer Checkmk-Bereiche verwendet werden, wie Sie auch im folgenden Beispiel für ein Top-Down-Dashboard sehen.

Sie kennen nun also alle verfügbaren Widgets und fertigen Dashboards, wissen, wo deren Konfigurationen und Layout-Optionen zu erreichen sind und wie man ein komplettes Dashboard zusammenbaut. Dashboards müssen aber nicht unbedingt ganz allein für sich stehen, sondern können auch aufeinander aufbauen — beispielsweise, um von einer großen Übersicht bis ins kleinste Detail zu navigieren.

Im Grunde funktionieren viele Widgets bereits genau so: Die Host statistics visualisieren die Host-Zustände, und ein Klick auf einen der Zustände leitet zu einer Ansicht weiter, die die zugehörigen Hosts auflistet. Von dort geht es wiederum weiter zu den einzelnen Services eines einzelnen Hosts.

Bei eigenen Dashboards können Sie auch Links auf andere Dashboards setzen, indem Sie die Titelzeile von Widgets via Widget settings > Interaction > Link title to in den Widget-Eigenschaften verlinken. Mal als konkretes Beispiel: Hier sehen Sie ein Dashboard, das Informationen zu CPU, RAM und Dateisystem mehrerer Hosts zeigt.

Der Titel des CPU-Graphen verlinkt hier ein weiteres Dashboard, welches die CPU-Informationen für jeden Host einzeln visualisiert. In diesem Dashboard gibt es wiederum ganz oben einen Link zurück zur Übersicht, einfach realisiert über ein Widget Static text.

Mit solchen Querverlinkungen können Sie komplexe Recherchewerkzeuge über Dashboards realisieren. Dabei sind Sie übrigens nicht auf die Titelzeile beschränkt. Als statischen Text können Sie durchaus HTML-Code verwenden und so ganze Navigationen einbauen. Denken Sie etwa an verteiltes Monitoring und Pfade wie Gesamtübersicht > Instanzübersicht > Host-Übersicht > Container-Übersicht > Services > Probleme.

Es kann vorkommen, dass Sie bei einem Widget lediglich folgende Meldung sehen:

Enter runtime filter to load data

In diesem Fall soll das Widget Informationen für nur einen Host und/oder Service anzeigen — für den aber kein Filter gesetzt wurde. Um das zu beheben, setzen Sie passende Runtime-Filter.

Für gänzlich leere Widgets bei ausbleibenden Fehlermeldungen kann es mehrere Gründe geben. In der Regel handelt es sich um eine Fehlkonfiguration des Widgets.

Beispiel: Sie erstellen ein Widget für die CPU-Auslastung mit der Metrik und dem gefilterten Service CPU load. Später ändern Sie den Filter der Service-Beschreibung auf etwa Check_MK Discovery, belassen die gewählte Metrik aber auf CPU load. Beim Anlegen eines Widgets kann Ihnen das nicht passieren, da nach dem Filter auf die CPU-Auslastung gar keine Auswahl einer unpassenden Metrik möglich ist — beim Umkonfigurieren von Widgets wird die ursprünglich gewählte Metrik jedoch beibehalten.

Die Lösung ist trivial: Passen Sie Service-Filter und gewählte Metrik in der Widget-Konfiguration an. Das gilt natürlich auch für alle anderen Widget-Varianten.