Watchdog: Festplatte

Überwacht die Belegung eines Mountpunkts in Prozent mit Warn- und Fehlerschwelle. Typ disk_space, Runner Agent. Felder, Standardwerte, Status und Meldungen.

English Version

Zurück zu den Check-Typen

Watchdog: Festplatte

Der Check liest Gesamt- und freien Speicher eines Pfads und berechnet die Belegung in Prozent.

Eigenschaft	Wert
Typ-Kennung	`disk_space`
Runner	Agent
Ziel in der E-Mail	`Path`

Felder

Feld	Schlüssel	Standard	Bedeutung
Mount path	`path`	`/`	Pflicht. Absoluter Pfad des Mountpunkts, zum Beispiel `/`, `/var` oder `/mnt/backup`
Warn threshold (%)	`warn_percent`	`80`	`WARN` ab dieser Belegung
Fail threshold (%)	`fail_percent`	`90`	`FAIL` ab dieser Belegung. Muss größer sein als die Warnschwelle

Ablauf

Ist die Umgebungsvariable HOST_ROOT im Agenten gesetzt, stellt der Check sie dem Pfad voran. Aus /var wird dann /host/root/var. Die Belegung ist (gesamt - frei) / gesamt, auf ganze Prozent gerundet. Sie kann daher geringfügig von der Use%-Spalte von df abweichen.

Situation	Status	Meldung
Belegung unter der Warnschwelle	`OK`	`<n>% used (<frei> free of <gesamt>)`
Belegung ab der Warnschwelle	`WARN`	`<n>% used (<frei> free of <gesamt>)`
Belegung ab der Fehlerschwelle	`FAIL`	`<n>% used (<frei> free of <gesamt>)`
Pfad existiert nicht oder ist kein Verzeichnis	`UNKNOWN`	`Path not found or not a directory: <Pfad>`
Fehlerschwelle nicht größer als Warnschwelle	`UNKNOWN`	`Invalid config: fail_percent must be greater than warn_percent`
Gesamtgröße nicht ermittelbar	`UNKNOWN`	`Cannot determine total disk space for <Pfad>`
Lesefehler	`FAIL`	`Cannot read disk space for path: <aufgelöster Pfad>`
Kein Pfad konfiguriert	`UNKNOWN`	`No path configured`

Größen erscheinen in KB, MB oder GB.

In den Meldungen Path not found or not a directory und Cannot determine total disk space steht der konfigurierte Pfad, etwa /var. Die Lesefehler-Meldung enthält dagegen den aufgelösten Pfad mit HOST_ROOT-Präfix, etwa /host/root/var.

Der Agent braucht das Volume /:/host/root:ro und HOST_ROOT=/host/root, sonst misst der Check das Dateisystem im Agenten-Container, siehe Agenten.