| Typ-ID | disk_space |
| Runner | Agent |
| Zweck | Überwacht die Festplatten-Auslastung mit konfigurierbaren Warn- und Fehler-Schwellwerten |
Der Festplatten-Check liest die Speicherauslastung eines konfigurierten Pfades und vergleicht die Nutzung in Prozent mit den konfigurierten Schwellwerten. Er meldet den aktuellen Nutzungsprozentsatz und die absoluten Werte (gesamt, belegt, frei) in der Check-Nachricht.
Dieser Check läuft nur auf einem Agenten (AgentOnly). Er liest das Dateisystem direkt — daher benötigt er das Host-Dateisystem-Volume und die HOST_ROOT-Umgebungsvariable.
Benötigte Agent-Konfiguration:
environment:
HOST_ROOT: /host/root
volumes:
- /:/host/root:ro
Der HOST_ROOT-Präfix wird dem konfigurierten Pfad vorangestellt, damit der Agent das Host-Dateisystem statt seines eigenen Container-Dateisystems liest.
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| Pfad | text |
Ja | / |
Zu prüfender Dateisystem-Pfad. Verwende / für das Root-Dateisystem, /var für eine separate Partition usw. |
| Warnschwelle (%) | number |
Nein | 80 |
Warn-Status wenn die Nutzung diesen Prozentwert überschreitet. |
| Fehler-Schwelle (%) | number |
Nein | 90 |
Fail-Status wenn die Nutzung diesen Prozentwert überschreitet. |
| Ergebnis | Status |
|---|---|
| Nutzung < Warnschwelle | ok |
| Nutzung >= Warnschwelle | warn |
| Nutzung >= Fehler-Schwelle | fail |
| Pfad nicht gefunden / nicht lesbar | unknown |
warn standardmäßig keine E-Mail-Alerts auslöst, löst erst die fail-Schwelle eine Benachrichtigung aus — die Warnschwelle dient als visueller Hinweis im Dashboard/var/lib/docker — das HOST_ROOT-Präfix wird automatisch hinzugefügt