checkmk-plugin-docker-ps/README.md

Checkmk Local Check: Docker Container Status

Checkmk Local Check zur Überwachung von Docker-Containern per docker ps.

Funktionsweise

Das Script prüft für jeden konfigurierten Container den Status:

Container-Status	Checkmk-Status
Up ... (running)	OK (0)
Exited ...	CRITICAL (2)
Restarting ...	CRITICAL (2)
Container nicht gefunden	CRITICAL (2)

Konfiguration

In der Datei docker_container_check.sh die Variable CONTAINERS anpassen:

CONTAINERS="webserver,database,redis"

Mehrere Container werden kommagetrennt angegeben.

Installation

1. Script auf den Zielhost kopieren:

scp docker_container_check.sh user@host:/usr/lib/check_mk_agent/local/

2. Ausführbar machen:

chmod +x /usr/lib/check_mk_agent/local/docker_container_check.sh

3. Sicherstellen, dass der Checkmk-Agent-Benutzer Docker-Befehle ausführen darf (Mitglied der Gruppe docker oder Ausführung via sudo).

4. In Checkmk eine Service-Erkennung auf dem Host durchführen — die neuen Services Docker_<containername> erscheinen automatisch.

Test

Manuell auf dem Host ausführen:

/usr/lib/check_mk_agent/local/docker_container_check.sh

Erwartete Ausgabe:

0 Docker_webserver - Up 3 hours
0 Docker_database - Up 3 hours
2 Docker_redis - Exited (1) 5 minutes ago

Hinweise

• Der Plugin-Pfad kann je nach Installation variieren (/usr/lib/check_mk_agent/local/ oder /usr/local/lib/check_mk_agent/local/).
• Falls der Agent als root läuft, funktioniert docker ps direkt. Andernfalls muss der Agent-Benutzer in der Gruppe docker sein.