File Age Check Reference

All parameters, thresholds, and configuration options for the file age check in octoja.

Written By Erdinc Akay

Last updated About 2 months ago

File Age Check Reference

The File Age Check monitors the last modification time of specific files and warns when files are stale or missing.

Configuration fields

FieldTypeRequiredDefaultDescription
Files to monitorListYes—One or more files, each with a path and thresholds
— File pathStringYes—Absolute file path
— Warning threshold (hours)HoursNo24Hours since last modification before a warning is triggered
— Critical threshold (hours)HoursNo48Hours since last modification before a critical result is triggered
Warn if file is missingBooleanNoYesWarns if the file does not exist
Critical if file is missingBooleanNoNoCritical if the file does not exist. Overrides Warn if file is missing — if both are set, a missing file is reported as Critical.

Collected metrics

  • Last modification time per file
  • File age in hours
  • File existence status

Platform support

PlatformSupported
WindowsYes
LinuxYes
macOSYes

Notes

  • The check runs every 60 minutes. The interval is fixed for this check and is not a field in the configuration form.
  • The check uses the file's last modification time, not the creation or access time.
  • Multiple files can be monitored in a single check, each with independent thresholds.
  • If Warning threshold (hours) is configured higher than Critical threshold (hours) for a file, the agent silently swaps the two thresholds for that target so the critical threshold is always greater than the warning threshold.
  • If the Files to monitor list is empty, the whole check reports a Warning result (rather than Success or an error).
  • The agent process must have read permission on the file. If reading the file's metadata throws (for example, an access-denied error in a restricted directory), the target reports the Error status (a distinct status, separate from Critical and Warning) and stores the exception message — truncated to 200 characters — in the errorMessage field.

See also: Configure a File Age Check