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:
- Check-Definition - Was wird geprueft? (Name, Kategorie, Scripts)
- Severity-Mapping - Wie werden Exit-Codes interpretiert?
- Auto-Remediation - Optionale automatische Fehlerbehebung
- Check-Jobs - Welche Hosts werden geprueft und wann?
Checks verwalten
Die Check-Verwaltung erreichen Sie ueber den Navigationspunkt Checks.
Check erstellen
- Klicken Sie auf Check erstellen
- Konfigurieren Sie den Check:
| Feld | Beschreibung | Pflicht |
|---|---|---|
| Name | Bezeichnung des Checks | Ja |
| Beschreibung | Was prueft dieser Check? | Nein |
| Kategorie | Organisationskategorie (frei waehlbar) | Nein |
| Modul | Fuer welche Module ist der Check verfuegbar | Ja |
| Scripts | Ein oder mehrere Scripts aus der Bibliothek | Ja |
| Aktiviert | Ob der Check ausfuehrbar ist | Ja |
Kategorien
Kategorien dienen der Organisation Ihrer Checks. Der Kategoriename ist frei waehlbar, gaengige Beispiele:
| Kategorie | Typische Pruefungen |
|---|---|
disk | Festplattenbelegung, SMART-Status |
memory | RAM-Auslastung, Swap-Nutzung |
services | Dienst-Verfuegbarkeit, Prozess-Pruefung |
security | Sicherheitsrichtlinien, Zertifikatsablauf |
custom | Benutzerdefinierte Pruefungen (Standard) |
Severity-Mapping
Das Severity-Mapping ordnet Exit-Codes eine Schwere zu:
| Exit-Code | Severity | Bedeutung |
|---|---|---|
| 0 | OK | Pruefung bestanden |
| 1 | Warning | Warnung |
| 2 | Critical | Kritisch |
| 3+ | Unknown | Unbekannt |
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.
| Art | Parameter | Ergebnis |
|---|---|---|
| CPU-Auslastung | Warnung/Kritisch ab %, Messdauer | Mittelwert über die Messdauer, Feld CPU_PERCENT |
| Arbeitsspeicher | Warnung/Kritisch ab % | belegter Speicher, Feld MEMORY_PERCENT |
| Plattenplatz | Warnung/Kritisch ab %, Laufwerk/Mountpoint (leer = alle) | das vollste Laufwerk zählt |
| Ping | Ziel, Anzahl, Verlust-Schwellen, optional Laufzeit | Felder PING_LOSS, PING_MS |
| Dienst läuft | Dienstname, automatischer Neustart | gestoppt = kritisch; neu gestartet = Warnung |
| Prozess läuft | Prozessname, Mindestanzahl | zu 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:
| Check | Warnung | Kritisch | Alarm nach |
|---|---|---|---|
| CPU-Auslastung (10 s Mittel) | 90 % | 95 % | 3 Fehlschlägen in Folge |
| Arbeitsspeicher | 90 % | 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:
| Parameter | Bedeutung |
|---|---|
| Protokoll | System, Application, Security oder z. B. Microsoft-Windows-Windows Defender/Operational |
| Ereignis-IDs | mit Komma getrennt, leer = alle |
| Quellen | optional, z. B. disk, Ntfs |
| Stufen | Kritisch, Fehler, Warnung |
| Zeitraum | 5 Minuten bis 7 Tage, passend zum Job waehlen (stuendlicher Job = 60 Minuten) |
| Warnung ab / Kritisch ab | Anzahl 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
| Feld | Beschreibung | Standard |
|---|---|---|
| Remediation aktiviert | Auto-Remediation ein-/ausschalten | Nein |
| Remediation-Script | Script, das bei Fehler ausgefuehrt wird | - |
| Max. Versuche | Maximale Anzahl Remediation-Versuche pro Fehlerserie (1-10) | 3 |
| Abkuehlzeit | Mindestzeit zwischen Remediation-Versuchen (in Sekunden, min. 60) | 300 (5 Min.) |
Ablauf
- Check wird ausgefuehrt und schlaegt fehl (Status: Warning oder Critical)
- Der Zaehler konsekutive Fehler wird erhoeht
- 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
- Das Remediation-Script laeuft mit erhoehter Prioritaet
- 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 zurueckgesetztChecks 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.
- Oeffnen Sie das Modul (z.B. OPNsense) und dort den Reiter Jobs
- Klicken Sie auf Neuer Job und waehlen Sie als Aktion Check
- Konfigurieren Sie:
| Feld | Beschreibung |
|---|---|
| Check | Welcher Check soll ausgefuehrt werden |
| Ziel | Alle Hosts des Moduls (auch spaeter hinzugefuegte), ein Kunde, eine Gruppe oder ein einzelner Host |
| Zeitplan | Wann soll der Check ausgefuehrt werden |
Zeitplan-Optionen
| Typ | Beschreibung |
|---|---|
| Einmalig | Einmalige Ausfuehrung zum geplanten Zeitpunkt |
| Taeglich | Jeden Tag zur angegebenen Uhrzeit |
| Woechentlich | Am gewaehlten Wochentag zur angegebenen Uhrzeit |
| Monatlich | Am gewaehlten Tag des Monats |
| Cron | Freie 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:
| Suche | Findet Hosts, bei denen ... |
|---|---|
checks:mss | ein Check mit "mss" im Namen ein Ergebnis hat |
checks:mss=ok | dieser Check zuletzt OK war |
checks:mss!=ok | dieser Check zuletzt nicht OK war (Warning, Critical, Unknown) |
checks:mss=warning,critical | dieser Check Warning oder Critical war |
checks:=critical | irgendein 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
- In der Jobs-Liste beim Check-Job auf Betroffene anzeigen klicken (oder z.B.
checks:mss!=oksuchen) - Bulk einschalten und mit dem Kopf-Haken alle angezeigten Hosts auswaehlen
- Ueber Script das passende Script ausfuehren
- 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:
# 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
#!/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
fiZeilen mit dem Praefix FIELD: werden vom Backend geparst:
- Format:
FIELD:feldname=wert - Der
feldnamewird 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
| Farbe | Severity | Bedeutung |
|---|---|---|
| Gruen | OK | Alles in Ordnung |
| Gelb | Warning | Aufmerksamkeit erforderlich |
| Rot | Critical | Sofortiges Handeln noetig |
| Grau | Unknown | Konnte 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
#!/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
fiDienst pruefen
#!/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
fiZertifikat pruefen
#!/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
fiVerhalten 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
unknownstatt 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).