Skip to main content
Backup

Apple Time Machine

Monitor the age of the newest completed Time Machine backup on Macs and catch missed backups in time.

The Apple Time Machine check monitors the age of a Mac's newest completed Time Machine backup and alerts when it is too old. It reads the Time Machine settings cached by macOS and evaluates the newest recorded completed backup across all configured backup destinations. Local snapshots on the startup volume do not count. The check runs on macOS only (Intel and Apple Silicon), every 60 minutes by default.

The check does not mount a backup destination, start a backup, or change any settings. A backup disk that is currently disconnected therefore does not raise an alert by itself; what counts is the age of the last completed backup. The check does not verify whether the destination is reachable or whether a backup can be restored.

Prerequisites

  • You need the Monitoring Check Management permission.
  • The target device is a Mac with a connected octoja agent.
  • Time Machine is set up on the Mac with at least one backup destination.
  • The agent is allowed to read the Time Machine settings on macOS.

Steps

  1. Go to Devices and open the Mac.
  2. Click the Checks tab → Add Check → Apple Time Machine.
  3. Adjust Warning after (hours) and Critical after (hours) if needed. The defaults of 24 and 48 hours suit daily backups.
  4. Click Add Check.

After the first check interval, the result appears in the device's Checks tab.

Settings

FieldTypeRequiredDefaultDescription
Warning after (hours)NumberNo24Age of the last completed backup at which the check warns. Positive number of hours; fractions are allowed
Critical after (hours)NumberNo48Age of the last completed backup at which the check reports Critical. Positive number of hours; fractions are allowed

If Warning after (hours) is higher than Critical after (hours), the check swaps the two values before evaluating. If a threshold is zero or negative, the check reports Failure.

Results

ConditionStatus
The last completed backup is younger than Warning after (hours)OK
The age reaches or exceeds Warning after (hours)Warning
The age reaches or exceeds Critical after (hours)Critical
No backup destination configuredCritical
No completed backup recordedCritical
The Time Machine settings cannot be read, reading them times out, or they contain invalid backup dataFailure
The thresholds are invalid, the check is not running on macOS, or an unexpected error occursFailure

If the check reports "Could not read Time Machine settings. Check macOS read permissions.", verify that the agent is allowed to read the Time Machine settings on the Mac.

Collected metrics

  • Time of the last completed backup
  • Age of the last completed backup in hours

Tips

  • Set the warning threshold to match the backup rhythm. If a Mac is only occasionally connected to its backup disk, choose larger values so the check does not alert between two planned backups.