Configure a Veeam Agent Check

Step-by-step guide to setting up the Veeam Agent check in octoja to monitor Veeam Agent for Windows backups on an endpoint.

Written By Stefan Steuer

Last updated 28 days ago

The Veeam Agent check monitors Veeam Agent for Windows on an endpoint — the per-machine backup agent, as opposed to a central Veeam Backup & Replication server. It reads the agent's backup results from the Windows event log and reports each job's outcome and age, plus the license state.

Prerequisites

This check runs on the endpoint, so set it up on the machine that runs Veeam Agent.

  • You need the Monitoring Check Management permission. Permissions are assigned under Administration → Groups.
  • An octoja agent installed on the same Windows endpoint as Veeam Agent for Windows.
  • At least one completed Veeam Agent backup within the lookback window.

Steps

Add the check on the endpoint you want to watch.

  1. Go to Devices and open the Windows endpoint that runs Veeam Agent.
  2. Click the Checks tab → Add CheckVeeam Backup Agent.
  3. Keep Require the agent to be present on so the check flags machines where Veeam Agent is missing, and keep Evaluate license events on to be warned about an expired or grace-period license.
  4. (Optional) Under the advanced options, set Warning after (hours) and Critical after (hours) for how old the last successful backup may be (defaults 30 and 50 hours), and the event log lookback (days) (default 14).
  5. Click Add Check.

What triggers an alert?

ConditionSeverity
Veeam Agent is missing while Require the agent to be present is onCritical
No completed backup in the lookback window, or the latest job ended in errorCritical
A successful backup is older than the critical thresholdCritical
The latest job ended with a warning, a backup is older than the warning threshold, or a license event is presentWarning
The latest backups completed successfully within the thresholdsOK

Tips

  • Turn off Require the agent to be present if you assign the check broadly and only some machines run Veeam Agent — the check then passes on machines without it.
  • The check reads backup outcomes from the Windows event log and needs no admin rights and no network access.
  • For a central Veeam Backup & Replication server, use the Veeam Backup check instead.

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

See also: Veeam Agent Check Reference — fields, thresholds, and states.