Docker-Container-Check-Referenz

Konfigurationsoptionen für den Docker-Container-Check

Docker-Container-Check-Referenz

Der Docker-Container-Check überwacht Docker-Container auf dem Zielgerät und warnt bei gestoppten Containern, ungesundem Status und übermäßigen Neustarts.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Alle Container überwachen	Boolean	Nein	Ja	Jeden Container auf dem Host überwachen. Wenn aktiviert, wird die Liste „Ausgeschlossene Container“ als Blacklist-Filter angewendet.
Container-Namen	Liste von Strings	Nein	—	Bestimmte Containernamen zur Überwachung (Abgleich nur über den Namen, nicht über die Container-ID). Unterstützt Platzhalter: `` für beliebige Zeichen, `?` für ein einzelnes Zeichen (z. B. `web-`). Der Abgleich ignoriert Groß- und Kleinschreibung, und ein Eintrag ohne Platzhalter muss dem gesamten Namen entsprechen — `web` passt nicht auf `web-01`. Wird nur angezeigt, wenn Alle Container überwachen deaktiviert ist.
Ausgeschlossene Container	Liste von Strings	Nein	—	Containernamen, die ausgeschlossen werden, wenn „Alle Container überwachen“ aktiviert ist. Unterstützt dieselben Platzhalter (``, `?`) und denselben Abgleich über den gesamten Namen ohne Beachtung der Groß- und Kleinschreibung. Wird nur angezeigt, wenn Alle Container überwachen* aktiviert ist.
Warnung bei gestoppten Containern	Boolean	Nein	Ja	Warnung, wenn ein Container nicht läuft
Kritisch bei gestoppten Containern	Boolean	Nein	Nein	Kritisch statt Warnung, wenn ein Container nicht läuft. Diese Einstellung hat Vorrang: Ist sie aktiviert, ist ein gestoppter Container kritisch, auch wenn Warnung bei gestoppten Containern deaktiviert ist.
Warnung bei ungesunden Containern	Boolean	Nein	Ja	Warnung, wenn der Health-Check eines Containers `unhealthy` meldet. Ein Container im Zustand `starting` löst keinen Alarm aus.
Maximale Neustarts	Ganzzahl	Nein	5	Warnung, wenn die Neustartanzahl eines Containers diesen Wert überschreitet

Erfasste Metriken

Containername
Image
Container-Status (der rohe Docker-Status, z. B. running, paused, restarting, exited)
Zustandsstatus (healthy / unhealthy — wird nur bei Containern mit Health-Check angezeigt)
Neustartanzahl
Gesamtzahl der Container

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja
Linux	Ja
macOS	Ja (Docker Desktop)

Hinweise

Der Check ruft die docker-CLI auf. Die ausführbare Datei docker muss im PATH des Agenten verfügbar sein, und das Konto des Agenten muss berechtigt sein, sie auszuführen (unter Linux bedeutet das in der Regel Mitgliedschaft in der Gruppe docker; unter Windows den CLI-Zugriff von Docker Desktop).
Der Check liest docker ps --format json aus; dafür benötigt der Host Docker Engine 23.0 oder neuer. Ältere Engines melden keine Container.
Container ohne konfigurierten Health-Check zeigen in der Ergebnisansicht keinen Zustandsstatus an.
Maximale Neustarts kann statt einer festen Zahl ein eigenes Gerätefeld lesen: Eigenes Feld einfügen schreibt den Token, und Geräte ohne eigenen Wert greifen auf den Standardwert des Feldes zurück. Die Option erscheint, sobald im Mandanten ein eigenes Gerätefeld vom Typ Ganzzahl vorhanden ist.
Die Neustartanzahl ist kumulativ seit der Container-Erstellung, nicht seit dem letzten Check-Lauf.
Wenn keine Container passen — leerer Docker-Host, ein Filter, der alles ausschließt, oder Alle Container überwachen deaktiviert ohne Einträge unter Container-Namen —, liefert der Check Warnung mit einer Gesamtzahl von 0 Containern.
Wenn der docker-Befehl selbst fehlschlägt — nicht installiert, nicht erreichbar oder keine Antwort innerhalb von 15 Sekunden —, liefert der Check Warnung.
Der Check läuft in einem festen Intervall von 5 Minuten; das Intervall ist kein konfigurierbares Feld im Check-Editor.

Siehe auch: Docker-Container-Check konfigurieren