Dateialter-Check-Referenz

Alle Parameter, Schwellenwerte und Konfigurationsoptionen für den Dateialter-Check in octoja.

Dateialter-Check-Referenz

Der Dateialter-Check überwacht den letzten Änderungszeitpunkt einer Datei — oder, wenn der Pfad auf einen Ordner zeigt, der neuesten passenden Datei in diesem Ordner — und warnt, wenn eine Datei veraltet oder fehlend ist.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Zu überwachende Dateien oder Ordner	Liste	Ja	—	Ein oder mehrere Einträge, jeweils mit Pfad, Muster und Schwellenwerten
— Dateipfad	String	Ja	—	Absoluter Pfad zu einer Datei oder einem Ordner
— Dateimuster	String	Nein	`*`	Bei einem Ordnerpfad wird die neueste passende Datei ausgewählt — zum Beispiel `*.bak`. Zeigt der Pfad auf eine Datei, wird das Muster nicht verwendet.
— Warnung (Stunden)	Stunden	Nein	24	Stunden seit der letzten Änderung, bevor eine Warnung ausgelöst wird
— Kritisch (Stunden)	Stunden	Nein	48	Stunden seit der letzten Änderung, bevor ein kritisches Ergebnis ausgelöst wird
Warnung bei fehlender Datei	Boolean	Nein	Ja	Warnung, wenn die Datei nicht existiert
Kritisch bei fehlender Datei	Boolean	Nein	Nein	Kritisch, wenn die Datei nicht existiert. Überschreibt Warnung bei fehlender Datei — wenn beide gesetzt sind, wird eine fehlende Datei als Kritisch gemeldet.

Erfasste Metriken

Letzter Änderungszeitpunkt pro Eintrag
Dateialter in Stunden
Existenzstatus der Datei
Der Pfad der tatsächlich gemessenen Datei, wenn der Eintrag auf einen Ordner zeigt

Plattformunterstützung

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

Hinweise

Der Check läuft alle 60 Minuten. Das Intervall ist für diesen Check fest vorgegeben und kein Feld im Konfigurationsformular.
Der Check verwendet den letzten Änderungszeitpunkt der Datei, nicht den Erstellungs- oder Zugriffszeitpunkt.
Zeigt ein Pfad auf einen Ordner, misst der Check die neueste Datei in diesem Ordner, die zu Dateimuster passt. Durchsucht wird nur der Ordner selbst — Dateien in Unterordnern werden ignoriert. Die Check-Details nennen die gemessene Datei.
Existiert der Ordner, passt aber keine Datei zum Muster, wird der Eintrag wie eine fehlende Datei behandelt: Warnung bei fehlender Datei und Kritisch bei fehlender Datei bestimmen das Ergebnis, und die Check-Details zeigen Keine passende Datei gefunden.
Mehrere Einträge können in einem einzelnen Check überwacht werden, jeweils mit unabhängigen Schwellenwerten. Das Gesamtergebnis des Checks ist das schlechteste Ergebnis aller Einträge.
Wird Warnung (Stunden) für eine Datei höher konfiguriert als Kritisch (Stunden), vertauscht der Agent die beiden Schwellenwerte für dieses Ziel stillschweigend, sodass der kritische Schwellenwert immer größer als der Warnschwellenwert ist.
Sind sowohl Warnung bei fehlender Datei als auch Kritisch bei fehlender Datei ausgeschaltet, meldet eine fehlende Datei Erfolg.
Ist die Liste Zu überwachende Dateien oder Ordner leer, meldet der gesamte Check ein Warnungs-Ergebnis (statt Erfolg oder eines Fehlers).
Der Agent-Prozess muss Leseberechtigung für die Datei oder den Ordner haben. Wirft das Lesen der Metadaten eine Ausnahme (zum Beispiel ein „Zugriff verweigert“-Fehler in einem eingeschränkten Verzeichnis), meldet der Eintrag den Status Fehler (ein eigenständiger Status, getrennt von Kritisch und Warnung) und speichert die Ausnahmemeldung — auf 200 Zeichen gekürzt — im Feld errorMessage.

Siehe auch: Einen Dateialter-Check konfigurieren