Veeam Backup & Replication¶

Monitors Veeam Backup & Replication v13 via the REST API. Collects job status, repository capacity, license usage, proxy health, protected objects, and infrastructure server availability.

License: Pro

Prerequisites¶

Veeam Backup & Replication v13 or later
A Veeam account with Backup Administrator role (Backup Viewer is not sufficient for the REST API)
Network access from the agent to the Veeam server on port 9419 (REST API)

Configuration¶

probes:
  - name: veeam-prod
    type: veeam
    params:
      endpoint: "https://veeam-server"
      port: 9419
      username: 'DOMAIN\svc_monitoring'
      password: 'password'
      interval: 300
      verify_ssl: false
      hours_to_check: 24

Parameters¶

Parameter	Required	Default	Description
`endpoint`	Yes	-	Veeam server hostname or IP (without port)
`port`	No	`9419`	REST API port
`username`	Yes	-	Veeam account with Backup Administrator role
`password`	Yes	-	Account password
`interval`	No	`300`	Collection interval in seconds
`verify_ssl`	No	`true`	Verify TLS certificate
`hours_to_check`	No	`24`	Time window for job history (hours)

Collected Metrics¶

Job Overview¶

Aggregated job counts by type (VSphereBackup, WindowsAgentBackup, BackupCopy, etc.):

Metric	Unit	Description
`veeam_jobs_total`	Count	Total enabled jobs with activity in the time window
`veeam_jobs_success`	Count	Jobs with last run successful
`veeam_jobs_warning`	Count	Jobs with last run warnings
`veeam_jobs_failed`	Count	Jobs with last run failed
`veeam_jobs_running`	Count	Jobs currently running

Job Details¶

Per-job metrics for each active backup job:

Metric	Unit	Description
`veeam_job_status`	Lookup	Last run result (None/Success/Warning/Failed/Running)
`veeam_job_seconds_since`	Seconds	Time since last run
`veeam_job_objects_count`	Count	Number of objects processed
`veeam_job_bottleneck`	Lookup	Bottleneck type (None/Source/Proxy/Network/Target)
`veeam_job_processed_bytes`	Bytes	Total disk size processed
`veeam_job_read_bytes`	Bytes	Data read from source
`veeam_job_transferred_bytes`	Bytes	Data transferred after dedup/compression

Repositories¶

Per-repository capacity metrics:

Metric	Unit	Description
`veeam_repo_capacity`	Bytes	Total repository capacity
`veeam_repo_used`	Bytes	Used space
`veeam_repo_free`	Bytes	Free space
`veeam_repo_free_pct`	Percent	Free space percentage

License¶

Metric	Unit	Description
`veeam_license_status`	Lookup	Valid / Expired / Invalid
`veeam_license_days_left`	Days	Days until license expiration
`veeam_license_instances_total`	Count	Licensed instances
`veeam_license_instances_used`	Count	Used instances
`veeam_license_instances_remaining`	Count	Available instances

Proxies¶

Per-proxy status:

Metric	Unit	Description
`veeam_proxy_status`	Lookup	Disabled / Offline / Online
`veeam_proxies_total`	Count	Total proxies
`veeam_proxies_enabled`	Count	Enabled proxies
`veeam_proxies_disabled`	Count	Disabled proxies

Protected Objects¶

Per-object backup status:

Metric	Unit	Description
`veeam_object_restore_points`	Count	Number of restore points
`veeam_object_last_run_failed`	Count	1 if last backup failed, 0 otherwise
`veeam_objects_total`	Count	Total protected objects
`veeam_objects_failed`	Count	Objects whose last backup failed

Infrastructure¶

Managed server availability:

Metric	Unit	Description
`veeam_server_status`	Lookup	Available / Unavailable
`veeam_servers_total`	Count	Total managed servers
`veeam_servers_available`	Count	Available servers
`veeam_servers_unavailable`	Count	Unavailable servers

PRTG Integration¶

The probe includes PRTG lookups for status fields. When creating PRTG sensors, use the REST Custom sensor type pointing to:

http://<agent-ip>:<port>/api/<agent-key>/prtg/metrics/<probe-name>?tags=metric_type:<category>

Available categories: overview, jobs, repositories, license, proxies, protected_objects, infrastructure.

Example for job details:

http://192.168.1.100:8056/api/17b3cf0a-.../prtg/metrics/veeam-prod?tags=metric_type:jobs

Download the PRTG lookup files from the web interface (button "PRTG Lookups" in the Sensor Builder).

Troubleshooting¶

HTTP 403 on startup¶

The Veeam account must have the Backup Administrator role. The REST API does not work with Backup Viewer.

HTTP 500 on job collection¶

Some Veeam installations have job types (e.g., HyperVBackup) that cause server-side errors. The agent handles this automatically by querying jobs per type.

No job metrics¶

If hours_to_check is too short, jobs that ran outside the time window are excluded. Increase the value (default: 24 hours).