Skip to content

Health-Checks ​

Health-Checks ueberwachen den Zustand Ihrer Hosts durch automatisierte Pruefungen. Sie definieren Checks einmal und verteilen sie per Job auf beliebig viele Hosts.

Konzept ​

Ein Health-Check besteht aus:

  1. Check-Definition - Was wird geprueft? (Name, Kategorie, Scripts)
  2. Severity-Mapping - Wie werden Exit-Codes interpretiert?
  3. Auto-Remediation - Optionale automatische Fehlerbehebung
  4. Check-Jobs - Welche Hosts werden geprueft und wann?

Checks verwalten ​

Die Check-Verwaltung erreichen Sie ueber den Navigationspunkt Checks.

Check erstellen ​

  1. Klicken Sie auf Check erstellen
  2. Konfigurieren Sie den Check:
FeldBeschreibungPflicht
NameBezeichnung des ChecksJa
BeschreibungWas prueft dieser Check?Nein
KategorieOrganisationskategorie (frei waehlbar)Nein
ModulFuer welche Module ist der Check verfuegbarJa
ScriptsEin oder mehrere Scripts aus der BibliothekJa
AktiviertOb der Check ausfuehrbar istJa

Kategorien ​

Kategorien dienen der Organisation Ihrer Checks. Der Kategoriename ist frei waehlbar, gaengige Beispiele:

KategorieTypische Pruefungen
diskFestplattenbelegung, SMART-Status
memoryRAM-Auslastung, Swap-Nutzung
servicesDienst-Verfuegbarkeit, Prozess-Pruefung
securitySicherheitsrichtlinien, Zertifikatsablauf
customBenutzerdefinierte Pruefungen (Standard)

Severity-Mapping ​

Das Severity-Mapping ordnet Exit-Codes eine Schwere zu:

Exit-CodeSeverityBedeutung
0OKPruefung bestanden
1WarningWarnung
2CriticalKritisch
3+UnknownUnbekannt

Nagios-kompatibel

Das Mapping folgt der Nagios-Plugin-Konvention. Bestehende Monitoring-Scripts koennen direkt wiederverwendet werden.

Vordefinierte Checks ​

DATAZONE Control legt vordefinierte Checks fuer OPNsense an: IPsec MSS-Clamping (siehe OPNsense) sowie OPNsense Legacy-IPsec und OPNsense Legacy-Firewall-Regeln (siehe Legacy-Migration). Sie werden nur einmal angelegt und danach nicht mehr ueberschrieben, eigene Anpassungen bleiben erhalten. Die Auto-Remediation ist ausgeschaltet.

Fuer macOS (ab v3.22.0) gibt es vordefinierte Checks fuer FileVault aus und SIP aus (kritisch) sowie Firewall aus, Gatekeeper aus, Sicherheitsupdate seit mehr als 14 Tagen offen und Akku-Service empfohlen (Warnung), siehe macOS.

Multi-Script-Checks ​

Ein Check kann mehrere Scripts enthalten, die nacheinander ausgefuehrt werden:

  • Die Scripts werden in der definierten Reihenfolge ausgefuehrt
  • Bei aktiviertem Stop on Failure (Standard: Ja) wird die Ausfuehrung beim ersten Fehler abgebrochen
  • Der Gesamt-Status ergibt sich aus dem schlechtesten Einzelergebnis

Standard-Checks ohne Script (ab v3.31.0) ​

Für häufige Prüfungen muss kein Script geschrieben werden. Im Check-Dialog unter Art des Checks einen Standard-Check wählen und Schwellen eintragen; Control erzeugt das passende Script für Windows (PowerShell), Linux/PVE/PBS, OPNsense (FreeBSD) und macOS selbst. Ein Agent-Update ist nicht nötig.

ArtParameterErgebnis
CPU-AuslastungWarnung/Kritisch ab %, MessdauerMittelwert über die Messdauer, Feld CPU_PERCENT
ArbeitsspeicherWarnung/Kritisch ab %belegter Speicher, Feld MEMORY_PERCENT
PlattenplatzWarnung/Kritisch ab %, Laufwerk/Mountpoint (leer = alle)das vollste Laufwerk zählt
PingZiel, Anzahl, Verlust-Schwellen, optional LaufzeitFelder PING_LOSS, PING_MS
Dienst läuftDienstname, automatischer Neustartgestoppt = kritisch; neu gestartet = Warnung
Prozess läuftProzessname, Mindestanzahlzu wenige = kritisch

Standard-Checks werden wie alle Checks über Jobs verteilt. Die Werte landen im Ergebnis und können per Custom-Field-Mapping in Felder übernommen werden.

Vorbelegte Standard-Checks (ab v3.31.2) ​

Für jedes Modul (Windows, Linux, PVE, PBS, OPNsense, macOS) legt Control drei Standard-Checks fertig an. Sie stehen unter Automatisierung → Checks und im Job-Formular zur Auswahl:

CheckWarnungKritischAlarm nach
CPU-Auslastung (10 s Mittel)90 %95 %3 Fehlschlägen in Folge
Arbeitsspeicher90 %95 %2 Fehlschlägen in Folge
Plattenplatz (alle Laufwerke)85 %95 %1 Fehlschlag

Sie laufen erst, wenn ein Job sie verteilt (Jobs → Neuer Job → Aktion Check). Erst dann erscheinen sie im Host unter Checks. Schwellen kannst du im Check anpassen. Gelöschte Standard-Checks legt Control nicht wieder an. Hatte ein Modul schon einen eigenen Check derselben Art, legt Control keinen zusätzlichen an.

Windows-Ereignisse und Plattengesundheit (ab v3.69.0) ​

Windows-Ereignisse (nur Windows) zaehlt Ereignisse im Ereignisprotokoll (Get-WinEvent) und zeigt die letzten fuenf:

ParameterBedeutung
ProtokollSystem, Application, Security oder z. B. Microsoft-Windows-Windows Defender/Operational
Ereignis-IDsmit Komma getrennt, leer = alle
Quellenoptional, z. B. disk, Ntfs
StufenKritisch, Fehler, Warnung
Zeitraum5 Minuten bis 7 Tage, passend zum Job waehlen (stuendlicher Job = 60 Minuten)
Warnung ab / Kritisch abAnzahl der Ereignisse (Kritisch 0 = nie)

Beispiele: Plattenfehler (System, IDs 7, 51, 153), unerwarteter Neustart (System, ID 41), gesperrtes Konto (Security, ID 4740), Defender-Fund (Defender/Operational, IDs 1116, 1117). Feld EVENT_COUNT.

Plattengesundheit (SMART) prueft die physischen Platten: Windows ueber Get-PhysicalDisk, die Zuverlaessigkeitszaehler und die SMART-Vorhersage, Linux/Proxmox/PBS/OPNsense ueber smartctl (Paket smartmontools, fehlt es, meldet der Check unbekannt mit Hinweis), macOS ueber den SMART-Status von diskutil. Kritisch bei defekter Platte oder vorhergesagtem Ausfall, Warnung bei Verschleiss (Standard ab 80 %), Temperatur (ab 60 Grad), umgelagerten oder ausstehenden Sektoren und Lesefehlern. Virtuelle Platten ohne SMART zaehlen als ok. Feld DISK_HEALTH. Der Check ist fuer Windows, Linux, Proxmox, PBS und macOS vorbelegt; er laeuft wie alle Checks erst ueber einen Job.

Alarm erst nach mehreren Fehlschlägen (ab v3.31.0) ​

Alarm erst nach … Fehlschlägen in Folge (Standard 1 = sofort) gilt für Benachrichtigungen und die automatische Behebung. Bei 3 wird erst gemeldet, wenn die letzten drei Läufe des Checks auf dem Rechner nicht OK waren – kurze Ausreißer erzeugen keinen Alarm mehr. Läufe von Behebungs- oder Entwarnungs-Scripts zählen nicht mit.

Script bei Entwarnung (ab v3.31.0) ​

Optional läuft ein Script einmal, wenn der Check auf einem Rechner nach einem Fehler wieder OK ist – z. B. um einen Wartungsmodus zu beenden oder ein Ticket zu schließen. Das Gegenstück ist die automatische Behebung (Script bei Fehler).

Auto-Remediation ​

Die automatische Fehlerbehebung fuehrt ein Remediation-Script aus, wenn ein Check fehlschlaegt.

Konfiguration ​

FeldBeschreibungStandard
Remediation aktiviertAuto-Remediation ein-/ausschaltenNein
Remediation-ScriptScript, das bei Fehler ausgefuehrt wird-
Max. VersucheMaximale Anzahl Remediation-Versuche pro Fehlerserie (1-10)3
AbkuehlzeitMindestzeit zwischen Remediation-Versuchen (in Sekunden, min. 60)300 (5 Min.)

Ablauf ​

  1. Check wird ausgefuehrt und schlaegt fehl (Status: Warning oder Critical)
  2. Der Zaehler konsekutive Fehler wird erhoeht
  3. Wenn die Fehleranzahl das Grace Failures-Limit (Standard: 1) erreicht:
    • Und die maximale Versuchsanzahl nicht ueberschritten ist
    • Und die Abkuehlzeit seit dem letzten Versuch abgelaufen ist → Wird das Remediation-Script ausgefuehrt
  4. Das Remediation-Script laeuft mit erhoehter Prioritaet
  5. Beim naechsten erfolgreichen Check werden alle Zaehler zurueckgesetzt

Beispiel ​

Check: "Nginx laeuft"
Script: Prueft ob nginx aktiv ist (exit 0 = ok, exit 2 = critical)
Remediation-Script: systemctl restart nginx
Max. Versuche: 3
Abkuehlzeit: 300 Sekunden

Ablauf:
1. Check ergibt "Critical" → Zaehler: 1/1 (Grace erreicht)
2. → Remediation: nginx wird neugestartet (Versuch 1/3)
3. Naechster Check: Immer noch "Critical" → Zaehler: 2
4. → Abkuehlzeit pruefen: 300s vergangen? → Remediation (Versuch 2/3)
5. Naechster Check: "OK" → Alle Zaehler zurueckgesetzt

Checks verteilen (Check-Jobs, ab v3.8.0) ​

Checks werden wie Updates und Scripts ueber Jobs verteilt. Ein Check-Job deckt beliebig viele Hosts ab, z.B. alle Firewalls mit einem einzigen Eintrag.

  1. Oeffnen Sie das Modul (z.B. OPNsense) und dort den Reiter Jobs
  2. Klicken Sie auf Neuer Job und waehlen Sie als Aktion Check
  3. Konfigurieren Sie:
FeldBeschreibung
CheckWelcher Check soll ausgefuehrt werden
ZielAlle Hosts des Moduls (auch spaeter hinzugefuegte), ein Kunde, eine Gruppe oder ein einzelner Host
ZeitplanWann soll der Check ausgefuehrt werden

Zeitplan-Optionen ​

TypBeschreibung
EinmaligEinmalige Ausfuehrung zum geplanten Zeitpunkt
TaeglichJeden Tag zur angegebenen Uhrzeit
WoechentlichAm gewaehlten Wochentag zur angegebenen Uhrzeit
MonatlichAm gewaehlten Tag des Monats
CronFreie Cron-Expression (z.B. */5 * * * * fuer alle 5 Minuten)

Zusammenfassung in der Jobs-Liste ​

Bei Check-Jobs zeigt die Jobs-Liste das letzte Ergebnis ueber alle Zielhosts, z.B. 3 OK, 70 nicht OK, 4 ohne Ergebnis. Betroffene anzeigen wechselt in die Host-Liste und filtert auf die Hosts, bei denen der Check nicht OK ist.

Umstellung von Zuweisungen

Bis v3.7 wurden Checks einzeln pro Host zugewiesen. Mit v3.8.0 wurden alle bestehenden Zuweisungen automatisch in Check-Jobs umgewandelt (Name Check: <Check> (Zuweisung #<Nr>)). Zeitplan, Ziel und Aktiv-Status bleiben erhalten. Neue Zuweisungen lassen sich nicht mehr anlegen. Ausnahme: Gruppen-Zuweisungen bei OPNsense, Linux und Windows wurden nur stillgelegt, weil der Scheduler sie nie ausgefuehrt hat. Legen Sie dafuer bei Bedarf einen Check-Job mit Ziel Gruppe an.

Checks in der Host-Liste ​

Spalte Checks ​

Die Host-Listen aller Module haben die Spalte Checks. Sie zeigt pro Check einen farbigen Chip mit dem letzten Ergebnis (gruen OK, gelb Warning, rot Critical, grau Unknown). Der Tooltip zeigt Zeitpunkt und die FIELD:-Werte des Ergebnisses, z.B. SUGGESTED_MSS.

Ab v3.11.0 aktualisiert sich die Spalte live: Ein neues Ergebnis erscheint ohne Neuladen in der Liste und im Checks-Reiter des Host-Panels.

Nach Check-Status suchen ​

Die Suche der Host-Liste versteht die Spalte direkt. Der Status bezieht sich dabei immer auf denselben Check:

SucheFindet Hosts, bei denen ...
checks:mssein Check mit "mss" im Namen ein Ergebnis hat
checks:mss=okdieser Check zuletzt OK war
checks:mss!=okdieser Check zuletzt nicht OK war (Warning, Critical, Unknown)
checks:mss=warning,criticaldieser Check Warning oder Critical war
checks:=criticalirgendein Check Critical war
"checks:IPsec MSS-Clamping!=ok"Check-Namen mit Leerzeichen: ganzen Begriff in Anfuehrungszeichen

Statt checks: geht auch check:. Deutsche Status-Woerter (kritisch, warnung, unbekannt) werden ebenfalls erkannt. Hosts ohne Ergebnis fuer den Check werden von != nicht gefunden.

Freitext reicht nicht

Eine Suche nach mss critical findet auch Hosts, bei denen MSS OK ist und ein anderer Check kritisch ist. Verwenden Sie fuer Status-Abfragen immer checks:name=status.

Betroffene Hosts bearbeiten ​

  1. In der Jobs-Liste beim Check-Job auf Betroffene anzeigen klicken (oder z.B. checks:mss!=ok suchen)
  2. Bulk einschalten und mit dem Kopf-Haken alle angezeigten Hosts auswaehlen
  3. Ueber Script das passende Script ausfuehren
  4. Fertig: Ist das Script die Remediation des Checks, laeuft der Check danach automatisch erneut (siehe Nach-Check). Bei anderen Scripts den Check ueber Check von Hand erneut ausfuehren

Nur sichtbare Hosts

Bulk-Aktionen wirken ab v3.8.0 nur auf ausgewaehlte Hosts, die aktuell in der Liste sichtbar sind. Vorher markierte Hosts, die ein neuer Filter ausblendet, sind nicht mehr dabei.

Nach-Check nach Scripts (ab v3.11.0) ​

Nach einem erfolgreichen Script prueft Control automatisch, ob es gewirkt hat. Der Nach-Check laeuft, wenn alle Bedingungen zutreffen:

  • Das Script ist als Remediation-Script eines aktiven Checks hinterlegt, z.B. IPsec MSS-Clamping aktivieren beim Check IPsec MSS-Clamping
  • Das letzte Ergebnis dieses Checks auf dem Host war nicht OK
  • Das Script endete mit Exit-Code 0

Das gilt fuer Scripts aus der Bulk-Aktion, aus dem Script-Bereich, aus Jobs und fuer die Auto-Remediation. Schritte von Update-Laeufen und Playbooks loesen keinen Nach-Check aus. Ein Nach-Check loest selbst keinen weiteren aus. Das Ergebnis erscheint live in der Spalte Checks.

Werte aus Checks an Scripts uebergeben (ab v3.11.0) ​

Ein Script kann einen Wert aus dem letzten Check-Ergebnis des Hosts uebernehmen. Dafuer steht im Script eine Zeile:

bash
# DZ-CHECK-VAR: MSS=SUGGESTED_MSS
MSS="${MSS:-1350}"

Beim Abholen durch den Agent setzt Control direkt unter dem Shebang MSS auf den Wert von FIELD:SUGGESTED_MSS aus dem neuesten Check-Ergebnis des Hosts, das dieses Feld enthaelt. Jeder Host bekommt so seinen eigenen Wert. Ohne passendes Ergebnis bleibt die Zeile weg und der Standard im Script gilt.

  • Erlaubt sind Shell- und Python-Scripts. Bei PowerShell wird nichts ersetzt, weil param() die erste Anweisung sein muss
  • Uebernommen werden nur einfache Werte aus Buchstaben, Ziffern und . _ : / @ + -. Andere Werte werden verworfen
  • Zusaetzlich steht DZ_CHECK_VAR_<NAME> im Script, z.B. DZ_CHECK_VAR_MSS=SUGGESTED_MSS. Daran erkennt das Script, dass der Wert aus einem Check stammt
  • Der eingesetzte Wert steht in den Task-Parametern unter check_vars, mit Check-Ergebnis und Zeitpunkt

Custom Field Mappings ​

Checks koennen Script-Ausgaben in benutzerdefinierte Felder schreiben. Dazu muss das Check-Script spezielle Zeilen ausgeben:

Script-Ausgabe-Format ​

bash
#!/bin/bash
USAGE=$(df / | tail -1 | awk '{print $5}' | tr -d '%')
echo "FIELD:disk_usage=$USAGE"

if [ "$USAGE" -gt 90 ]; then
  echo "CRITICAL: Festplatte zu $USAGE% belegt"
  exit 2
else
  echo "OK: Festplatte zu $USAGE% belegt"
  exit 0
fi

Zeilen mit dem Praefix FIELD: werden vom Backend geparst:

  • Format: FIELD:feldname=wert
  • Der feldname wird ueber die Custom Field Mappings des Checks einem benutzerdefinierten Feld zugeordnet
  • Der Wert wird automatisch im entsprechenden Custom Field des Hosts gespeichert

Ergebnisse ​

Im Host-Detail ​

Im Tab Checks des Detail-Panels sehen Sie:

  • Pro Check das letzte Ergebnis mit Severity-Farbe
  • Die Check-Jobs, die diesen Host abdecken (oder "Manuell ausgefuehrt")
  • Zeitpunkt der letzten Pruefung
  • Button Jetzt ausfuehren pro Check
  • Die letzten Ergebnisse mit Ausgabe und ausgeloester Remediation

Farbcodierung ​

FarbeSeverityBedeutung
GruenOKAlles in Ordnung
GelbWarningAufmerksamkeit erforderlich
RotCriticalSofortiges Handeln noetig
GrauUnknownKonnte nicht geprueft werden

Ergebnis-Details ​

Jedes Check-Ergebnis enthaelt:

  • Status (ok/warning/critical/unknown)
  • Exit-Code des Scripts
  • Stdout - Standardausgabe
  • Stderr - Fehlerausgabe
  • Custom Field Updates - Welche Felder aktualisiert wurden
  • Remediation ausgeloest - Ob Auto-Remediation getriggert wurde
  • Start-/Endzeit und Dauer

Aufbewahrung

Check-Ergebnisse werden automatisch nach 30 Tagen geloescht.

Ausfuehrung ​

Checks werden ausgefuehrt:

  • Geplant nach dem Zeitplan des Check-Jobs
  • Manuell ueber "Jetzt ausfuehren" im Tab Checks eines Hosts oder ueber die Bulk-Aktion Check in der Host-Liste
  • Nach Updates als Health-Check in Update-Zeitplaenen

Nur online Rechner (ab v3.57.9)

Wiederkehrende Check-Jobs pruefen nur Rechner, die beim Lauf online sind. Ausgeschaltete Rechner bekommen keine wartende Aufgabe mehr, sie sind beim naechsten Lauf nach dem Einschalten wieder dabei. Einmalige Check-Jobs warten weiter auf offline Rechner. "Jetzt ausfuehren" legt die Aufgabe auch fuer offline Rechner an.

Beispiel-Checks ​

Festplattenbelegung pruefen ​

bash
#!/bin/bash
USAGE=$(df / | tail -1 | awk '{print $5}' | tr -d '%')
if [ "$USAGE" -gt 90 ]; then
  echo "CRITICAL: Festplatte zu $USAGE% belegt"
  exit 2
elif [ "$USAGE" -gt 80 ]; then
  echo "WARNING: Festplatte zu $USAGE% belegt"
  exit 1
else
  echo "OK: Festplatte zu $USAGE% belegt"
  exit 0
fi

Dienst pruefen ​

bash
#!/bin/bash
SERVICE="nginx"
if systemctl is-active --quiet $SERVICE; then
  echo "OK: $SERVICE laeuft"
  exit 0
else
  echo "CRITICAL: $SERVICE ist nicht aktiv"
  exit 2
fi

Zertifikat pruefen ​

bash
#!/bin/bash
DOMAIN="example.com"
DAYS=$(echo | openssl s_client -connect $DOMAIN:443 2>/dev/null | openssl x509 -noout -enddate 2>/dev/null | cut -d= -f2)
REMAINING=$(( ($(date -d "$DAYS" +%s) - $(date +%s)) / 86400 ))

if [ "$REMAINING" -lt 7 ]; then
  echo "CRITICAL: Zertifikat laeuft in $REMAINING Tagen ab"
  exit 2
elif [ "$REMAINING" -lt 30 ]; then
  echo "WARNING: Zertifikat laeuft in $REMAINING Tagen ab"
  exit 1
else
  echo "OK: Zertifikat gueltig fuer $REMAINING Tage"
  exit 0
fi

Verhalten seit v3.14.2 ​

  • Severity-Mapping greift auch bei Exit-Code ≠ 0. Der Agent meldet den Exit-Code jetzt immer mit; Exit 1 wird zu Warnung, Exit 2 zu kritisch. Vorher war jeder Check mit Exit ≠ 0 kritisch. Kritisch erzwungen wird nur noch ohne Exit-Code (Timeout, Startfehler).
  • Haengende Check-Tasks hinterlassen ein Ergebnis unknown statt den letzten (gruenen) Stand stehen zu lassen.
  • Nach-Check gibt es auch fuer Checks mit Modul alle.
  • Check jetzt ausfuehren und Check-Ergebnisse sind an Modulrecht und Kundenbindung gebunden.
  • Timeouts von System-Scripts werden bei Updates uebernommen (der IPsec-MSS-Check hat jetzt 900 s).
  • Die Checks-Spalte und die Lage reagieren auf Ergebnisse weiterhin live.

Soll-Software (ab v3.49.0, Windows) ​

Standard-Check-Typ Soll-Software: Du listest Programme mit ihrem Anzeigenamen (wie in „Apps & Features“, ein Teil genügt) und optional dem Chocolatey- bzw. winget-Paket. Fehlt ein Programm, ist der Check kritisch. Mit Fehlende nachinstallieren installiert Control es gleich (Chocolatey wird bei Bedarf eingerichtet) und prüft danach erneut. Als Check-Job auf eine Gruppe hältst du so die Grundausstattung aller Arbeitsplätze aktuell.

Namen und Paket-IDs sind auf Buchstaben, Ziffern und wenige Zeichen beschränkt (keine Anführungszeichen, Platzhalter oder Optionen).

DATAZONE Control Documentation