Widget-Referenz¶
Diese Seite beschreibt alle Widgets, die auf der Dashboard-Seite platziert werden können — in eigenen Dashboards ebenso wie in der angepassten Übersicht. Der Katalog im Bearbeiten-Modus gruppiert sie in Lage, Probleme, Verlauf, Geräte & Tenants, Messwerte, Logs und Inhalt.
Gemeinsame Einstellungen¶
Ein Klick auf ein Widget im Bearbeiten-Modus öffnet seine Einstellungen. Was ein Widget anbietet, hängt von seinem Zweck ab; immer gleich bedient werden:
| Bereich | Inhalt |
|---|---|
| Datenauswahl | Tenants (immer Mehrfachauswahl, leer = alle sichtbaren), Ordner (mit Unterordnern), Profile, Tags, Check-Typen, Geräte, einzelne Checks und Ausschlüsse — jeweils auch über Variablen. Die Geräte- und Check-Auswahl sucht am Server und zeigt Checks mit ihrem Gerät. |
| Zeitraum | eigener Zeitraum oder der des Dashboards (nur bei Widgets, die Verläufe zeigen) |
| Rahmen und Kopfzeile | Titel, Rahmen, Kopfzeile ein/aus |
| Farben | jede Farbe nennt ihr Kriterium; der Info-Knopf des Widgets zeigt Datenauswahl, Zeitraum und Farbbedeutung |
| Anzahl, Reihenfolge, Klick-Ziel, Spalten | wo vorhanden, an derselben Stelle und mit „Zurücksetzen" |
Die Daten folgen immer den Rechten des Betrachters. Scheitert eine Abfrage, zeigt das Widget den Fehler mit „Erneut versuchen".
Zeitgewichtet: Kennzahlen (Mittel, Minimum, Maximum, Summe) rechnen damit, wie lange ein Wert galt — nicht mit der Zahl gespeicherter Messpunkte. Bis zu drei Tagen wird exakt aus den Rohdaten gerechnet, darüber aus den stündlichen bzw. täglichen Verdichtungen; Minimum, Maximum und Summe bleiben dabei dieselbe Größe.
Viele Serien: Graph und Heatmap zeigen bei sehr vielen Treffern die wichtigsten Serien (Vorgabe 200, einstellbar bis 1000 — schlechtester Status und höchster Wert zuerst) mit dem Hinweis „N von M angezeigt — die wichtigsten zuerst".
Lage und Probleme¶
Die eingebaute Übersicht besteht aus den Widgets dieses und des nächsten Abschnitts; jedes lässt sich auch in ein eigenes Dashboard legen. Alle lassen sich über die Datenauswahl auf einen Ausschnitt eingrenzen.
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Lage (summary_state) |
Anteil OK an (OK + Probleme), Status-Balken, Zähler mit Links in die Fehlerübersicht. Downtime und Accepted zählen nicht als Problem. | Ausrichtung und Maßstab der Balken, welche Status-Segmente erscheinen |
Offene Probleme (summary_problems) |
Problemliste wie in der Fehlerübersicht, Reiter Offen · ACK · Accepted | mehrere Bereiche mit eigenen Filtern (dieselbe Filter-Oberfläche wie die Fehlerübersicht), Spalten, Bereiche nebeneinander, Anzahl, Reihenfolge (neueste oder schlimmster Status zuerst) |
Die frühere Status-Übersicht, das Kreisdiagramm (Statusverteilung) und das Problem-Widget älterer Dashboards werden beim Laden in diese beiden Widgets übernommen.
Verlauf¶
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Status-Wechsel (summary_activity) |
Wechsel je Stunde; Klick auf einen Balken öffnet die Wechsel dieser Stunde | Zeitfenster, Zählweise |
Unruhigste Checks (summary_noisiest) |
Checks mit den meisten Wechseln (Vorgabe 7 Tage, Top 5) | Zeitraum 1 Stunde bis 30 Tage, Anzahl 1–20 |
Zeitleiste (status_timeline) |
Status gewählter Checks über die Zeit — ein Streifen je Check | Zeitabschnitt (Vorgabe 1 h), schlimmster oder letzter Status je Abschnitt. Bei sehr vielen Abschnitten (Zeitraum / Breite × Checks über 100.000) wählt der Server selbst die nächst gröbere Stufe; das Widget zeigt dann „Aufgelöst in …". |
Check-Historie (check_history) |
gespeicherte Ergebnisse gewählter Checks, roh oder je Zeitabschnitt | Abschnitt raw, 5 m, 15 m, 30 m, 1 h, 6 h, 12 h, 1 d (Vorgabe), 7 d, 1 Monat; schlimmster oder letzter Status; Reihenfolge; Nachkommastellen |
Geräte und Tenants¶
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Geräte (summary_devices) |
Geräte mit Status-Balken; Geräte lassen sich oben anheften | Anzahl (Vorgabe 60, höchstens 200), Sortierung (schlimmste zuerst), Gruppierung nach Tenant oder Profil, nur Geräte mit Problemen, Spaltenbreite |
Tenants (summary_tenants) |
Zustand je Tenant; entfällt bei nur einem Tenant | Sortierung, Anzahl, Geräteanzahl anzeigen |
Bestand (summary_inventory) |
Hosts, Agents, Collectors, neu gefundene Geräte — jede Zahl ein Link | zusätzlich Checks, laufende Downtimes, aktive ACKs |
Die frühere Host-Übersicht (Host-Kacheln) älterer Dashboards wird als Geräte geladen.
Messwerte¶
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Zahl (stat) |
ein Wert groß — von einem Check, mehreren zusammengefasst oder als Statuszahl | Quelle (ein Check / Gruppe / Status), Aggregation (Vorgabe „letzter Wert"), Nachkommastellen (1), kleiner Verlauf darunter (an), Farbschwellen |
Tacho (gauge) |
ein Wert auf einer Skala mit farbigen Bändern | Skala (0–100), Einheit, Nachkommastellen, Farbbänder (Vorgabe WARNING ab 70, CRITICAL ab 90) |
Graph (line_chart) |
Messreihen im Zeitraum als Linien | Aggregation (Vorgabe Mittel), Fläche füllen, gestapelt, Lücken zeigen, Prozent-Achse (Vorgabe fest 0–100 %, wahlweise an die Werte angepasst), Anzahl Serien, Einheit, Nachkommastellen |
Balken (bar_chart) |
aktuelle Werte im Vergleich, sortiert und gedeckelt | waagrecht (an), Anzahl (10, bis 100), Sortierrichtung |
Rangliste (top_n) |
höchste oder niedrigste aktuelle Werte als Liste | Anzahl (10), Sortierrichtung |
Heatmap (heatmap) |
Messwerte als Farbraster — je Check über die Zeit oder je Stunde und Wochentag | Darstellung (automatisch / Zeit / Woche), Zellgröße, Anzahl Serien (200), Farben |
Tabelle (table) |
aktueller Stand jedes Checks | Spalten wählen, ordnen, umbenennen (Vorgabe Host, Service, Status, Wert, letzter Check; zusätzlich Einheit, Check-Typ, Tenant), Sortierung, Nachkommastellen |
Anomalien (anomaly_list) |
Anomalien mit Normalbereich und Dauer | Anzahl (20), Mindest-Abweichung, als normal markierte anzeigen |
Kapazitätsprognosen (prediction_list) |
Datenträger und Serien, die ihre Grenze bald erreichen — dringendste zuerst, Restzeit als Bereich | Horizont (0/7/14/30/90 Tage) |
Anomalien und Kapazitätsprognosen stehen nur im Katalog, wenn Anomalien & Prognosen eingeschaltet sind (Standard).
Logs¶
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Global Log (system_log) |
die neuesten Meldungen des Global Logs | dieselben Filter wie im Global Log, Anzahl (15, 5–100) |
Log Stream (log_stream) |
neueste Roh-Logs gewählter Geräte (Datei, journald, Eventlog) — siehe Logs | Geräte- und Check-Auswahl, Mindest-Schwere, Anzahl (50, 10–200) |
Inhalt¶
| Widget | Inhalt | Einstellbar u. a. |
|---|---|---|
Text / Notiz (text) |
Markdown-Notiz oder Abschnitts-Überschrift | Größe (XS–XXL, Vorgabe S), Ausrichtung, Fläche, Symbol, vertikal zentrieren |
Link (link_button) |
Knopf zu einer Seite, einem Gerät, Check, Ordner, Tenant, Dashboard, einer Karte oder Adresse | Ziel (Geräte, Dashboards & Co. über die ID — überlebt Umbenennen), Beschriftung, Beschreibung, Darstellung; klickbare Adressen nur http(s), mailto oder relativ |
In Freigabe-Links¶
Im Freigabe-Link fehlen Tenants, Bestand, Status-Wechsel, Unruhigste Checks, Geräte und Global Log ganz; alle anderen Widgets zeigen dort dieselben Werte wie angemeldet. Ein Besucher kann die Auswahl eines Widgets nur über freie Variablen einengen, nie erweitern.