Skip to main content
Backup

Xopero Backup

Use the Xopero Backup check to monitor the status, errors, age, and runtime of Xopero ONE Backup&Recovery Agent backup tasks.

The Xopero Backup check monitors the Xopero ONE Backup&Recovery Agent on a device. It reads the agent's local log files and evaluates the latest run of each backup task: status, errors and warnings, age of the last backup, and runtime. The check runs on Windows, Linux, and macOS (each as an x64 and an Arm64 build) every 60 minutes on the octoja agent.

Steps

Add the check on the device that runs the Xopero ONE agent.

  1. Open the device under Devices.
  2. Select Checks → Add Check → Xopero Backup.

For many devices, you can assign it with config packages.

Settings

FieldTypeRequiredDefaultDescription
Lookback period (hours)IntegerYes24How many hours back to search the logs for backup tasks
Warning threshold (hours)IntegerYes26Warning when a task's last successful backup is at least this old
Critical threshold (hours)IntegerYes48Critical when a task's last successful backup is at least this old
Check completion timeBooleanNoOnWarn when a backup task that is still running reaches the maximum completion time
Maximum completion time (minutes)IntegerNo240Runtime at which a task that is still running raises a warning. Only visible when Check completion time is on

If the warning threshold is higher than the critical threshold, the check swaps the two values before evaluating.

The check only finds tasks whose log entries fall within the Lookback period (hours). If the last backup is older, the check reports "no backup tasks found" instead of an age breach. Set the lookback period at least as large as the critical threshold so the age thresholds can apply.

Results

The check evaluates only the latest run per task name within the lookback period. The worst result across all tasks becomes the check status.

ConditionSeverity
The last run's status is Failed, Cancelled or AbortedCritical
The last run completed but reports errorsCritical
The last run completed and reports warningsWarning
The last completed backup has reached the critical thresholdCritical
The last completed backup has reached the warning thresholdWarning
A task that is still running has reached the Maximum completion time (minutes) and Check completion time is onWarning
There are no Xopero ONE log files on the deviceWarning
No backup tasks were found in the lookback periodWarning
An unexpected error occurs while reading or evaluatingFailure
All tasks completed without errors or warnings within the thresholds, or are still running within the completion timeOK

Collected metrics

For each backup task the check records:

  • Task name and status of the last run
  • Time of the last backup and its age in hours
  • Backup size, runtime and number of resources
  • Number of errors and warnings in the last run

Log directories

The check reads every .log file in the agent's log directory, including subfolders.

PlatformLog directory read
Windows%ProgramData%\Xopero ONE\Xopero ONE Backup&Recovery Agent\Logs
Linux/opt/XoperoONEBackupAgent/Xopero/Logs
macOS/Applications/XoperoONE/XoperoONEBackup&RecoveryAgent/device-app/Xopero/Logs

Notes

  • The maximum completion time only applies to tasks that are still running. The duration of completed runs is shown but not evaluated. Other intermediate task states are rated OK.
  • Age is measured from the backup creation time Xopero logs in the result, or from the time of the log entry when that is missing.
  • Individual log files that cannot be read are skipped; the rest are still evaluated.

See also: Set up alerts for a check