Ordnergrößen-Check-Referenz

Alle Parameter, Schwellenwerte und Konfigurationsoptionen für den Ordnergrößen-Check in octoja.

Ordnergrößen-Check-Referenz

Der Ordnergrößen-Check misst die Gesamtgröße bestimmter Verzeichnisse und warnt, wenn die Größe die konfigurierten Schwellenwerte erreicht oder überschreitet.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Zu überwachende Ordner	Liste	Ja	—	Ein oder mehrere Verzeichnisse, jeweils mit Pfad und Schwellenwerten
— Ordnerpfad	String	Ja	—	Absoluter Verzeichnispfad
— Warnung (GB)	Zahl	Nein	50	Größe in GB, die eine Warnung auslöst
— Kritisch (GB)	Zahl	Nein	100	Größe in GB, die ein kritisches Ergebnis auslöst
Unterordner einbeziehen	Boolean	Nein	Ja	Alle Dateien in Unterordnern einbeziehen

Ausführungsintervall

Der Check wird alle 60 Minuten (stündlich) ausgeführt. Das Intervall wird vom Check selbst festgelegt und ist nicht als instanzspezifisches Konfigurationsfeld verfügbar.

Erfasste Metriken

Größe je überwachtem Ordner (GB und Bytes) — es gibt keine aggregierte Gesamtsumme über alle Ordner
Dateianzahl je Ordner
Anzahl der Dateien je Ordner, die nicht gelesen werden konnten (Zugriff verweigert) — wird im Ergebnisdetail als „N Dateien nicht zugreifbar (Zugriff verweigert)“ ausgewiesen
Ergebnisstatus je Ordner sowie eine während des Scans aufgezeichnete Fehlermeldung

Ergebnisstatus

Jeder Ordner wird einzeln ausgewertet; das Gesamtergebnis des Checks ist das schlechteste Ordner-Ergebnis.

Situation	Ergebnis je Ordner
Größe unter dem Warnungs-Schwellenwert	OK
Größe erreicht oder überschreitet den Warnungs-/kritischen Schwellenwert	Warnung / Kritisch
Ordnerpfad existiert nicht	Kritisch, mit der Fehlermeldung „Verzeichnis nicht gefunden“ (`dir-not-found`)
Keine Datei im Ordner konnte gelesen werden	Die Fehlermeldung „Zugriff auf alle Dateien verweigert“ (`access-denied`) wird aufgezeichnet; die gemessene Größe ist 0, das Ergebnis folgt daher den Schwellenwerten (in der Regel OK)
Unerwarteter Fehler beim Scannen	Fehler (der Gesamtstatus des Checks im Reiter Checks des Geräts lautet Fehlgeschlagen)

Plattformunterstützung

Plattform	Unterstützt	Architekturen
Windows	Ja	x64, Arm64
Linux	Ja	x64, Arm64
macOS	Ja	x64, Arm64

Hinweise

Der Check berechnet die Größe durch Aufsummierung aller Dateigrößen im Verzeichnisbaum. Bei Verzeichnissen mit Millionen von Dateien kann die Ausführung langsamer sein.
Der Agent-Prozess muss Leseberechtigung für das Verzeichnis und seinen Inhalt haben.
Zeichnet ein Ordner einen Fehler auf, zeigt das Ergebnisdetail diese Meldung anstelle von Größe und Dateianzahl des Ordners an.
Liegt der Warnungs-Schwellenwert über dem kritischen Schwellenwert, vertauscht der Agent die beiden Werte stillschweigend vor der Auswertung — ein fehlkonfiguriertes Paar liefert trotzdem brauchbare Ergebnisse, maßgeblich bleibt jedoch der Konfigurationsbildschirm und nicht das Alarm-Payload.
Sind keine Ordner konfiguriert, meldet der Check Warnung (weder Fehler noch OK), um die leere Konfiguration sichtbar zu machen, ohne einen Vorfall auszulösen.
Die Behandlung symbolischer Links folgt den Standardvorgaben von .NET DirectoryInfo und wird vom Check nicht explizit aktiviert oder deaktiviert. Das Verhalten kann sich zwischen Windows, Linux und macOS unterscheiden — wenn Symlinks unterhalb eines überwachten Pfads auf große externe Verzeichnisse zeigen können, prüfe die ermittelte Gesamtsumme gegen deine Erwartung.

Siehe auch: Einen Ordnergrößen-Check konfigurieren