Watchdog: Check-Typen

Alle 15 eingebauten Check-Typen von Watchdog mit Runner-Zuordnung, Statuslogik und Links zur Referenz jedes Typs, dazu das Anlegen eines Checks.

English Version

Zurück zur Übersicht

Watchdog: Check-Typen

Watchdog bringt 15 eingebaute Check-Typen mit. Jeder Typ legt fest, wo er laufen darf.

Modus	Wo der Check läuft
Dashboard	Nur im Worker-Container des Dashboards. Der Typ braucht eine URL aus dem Client-Datensatz
Agent	Nur auf einem Agenten. Der Typ braucht direkten Zugriff auf die Maschine
Dashboard oder Agent	Netzwerk-Check, der von beiden Seiten laufen kann

Eingebaute Checks

Check	Typ-Kennung	Runner	Prüft
HTTP-Erreichbarkeit	`http`	Dashboard	Ob eine URL einen erwarteten Statuscode liefert
HTTP-Inhalt	`http_content`	Dashboard	Ob der Antworttext bestimmte Zeichenketten enthält oder nicht enthält
SSL-Zertifikat	`ssl_cert`	Dashboard	Restlaufzeit der TLS-Zertifikate mehrerer Hosts
DNS	`dns`	Dashboard oder Agent	Ob ein Hostname auflöst, optional auf eine erwartete IP
TCP-Port	`tcp_port`	Dashboard oder Agent	Ob ein TCP-Port Verbindungen annimmt
Redis	`redis`	Dashboard oder Agent	PING an einen Redis-Server und Antwort PONG
Datenbank	`database`	Dashboard oder Agent	Ob sich eine PDO-Verbindung aufbauen lässt
Docker-Container	`docker`	Dashboard oder Agent	Laufstatus und Health-Status eines Containers
Docker Exec	`docker_exec`	Dashboard oder Agent	Exit-Code eines Befehls im Container
Festplatte	`disk_space`	Agent	Belegung eines Mountpunkts in Prozent
Load Average	`load_average`	Agent	Systemlast im Verhältnis zur CPU-Zahl
Prozess	`process`	Agent	Ob ein Prozess läuft
Log-Datei	`log_file`	Agent	Aktualität einer Log-Datei und ein Muster darin
Datei-Alter	`file_age`	Agent	Wie lange eine Datei nicht geändert wurde
Dateigröße	`file_size`	Agent	Ob die Größe einer Datei im erlaubten Bereich liegt

Check anlegen

Öffne den Client und klicke auf + Add check.
Wähle den Check type. Das Formular zeigt die Felder des Typs.
Wähle den Runner. Typen, die nur eine Seite erlauben, setzen den Runner selbst. Bei Runner Agent wählst Du zusätzlich den Agent.
Lege Intervall oder tägliche Uhrzeit sowie die Aufbewahrung fest, siehe Konfiguration.
Speichere. Dashboard-Checks laufen beim nächsten Minutentakt des Scheduler-Containers, Agenten-Checks beim nächsten Tick des Agenten.

Mit Run now startest Du einen Check sofort.

Gemeinsame Regeln

Standardwerte: Felder, die Du leer lässt, ersetzt Watchdog beim Lauf durch die Standardwerte des Typs. Lässt Du alle Felder leer, speichert er die Standardwerte des Typs.
Status UNKNOWN: Ein Check liefert UNKNOWN, wenn er nicht sinnvoll laufen kann, etwa bei fehlender Konfiguration oder fehlendem Docker-Socket. Das löst keine Fehler-Mail aus.
Status WARN und FAIL: Beide lösen beim Wechsel aus OK oder UNKNOWN eine Fehler-Mail aus, siehe Benachrichtigungen.
Antwortzeit: Im Dashboard-Betrieb erfassen nur HTTP-Erreichbarkeit und HTTP-Inhalt eine Antwortzeit. Bei Agenten-Checks misst der Agent die Dauer jedes Laufs und meldet sie als Antwortzeit.
Zeitüberschreitung: Mehrere Typen haben ein Feld Timeout (seconds). TCP und Redis begrenzen den Wert auf 1 bis 60 Sekunden, Datenbank auf 1 bis 30 Sekunden.

Eigene Checks

Das Check-System ist erweiterbar. Eine PHP-Klasse mit CheckInterface und dem Tag watchdog.check erscheint automatisch in der Auswahl. Siehe Eigene Checks schreiben.