From 15c9b772304e212296132fd759397c32a52af3a2 Mon Sep 17 00:00:00 2001
From: Marsell Kukuljevic <mk@spearhead.systems>
Date: Thu, 25 Jun 2026 13:54:29 +0200
Subject: [PATCH] Improve VSPC policies support.

---
 .../libexec/agent_vspc_backup_checks          |  96 +++++++++++++++---
 .../2.3/vspc_backup_checks-0.4.0.mkp          | Bin 5256 -> 0 bytes
 .../2.3/vspc_backup_checks-0.5.0.mkp          | Bin 0 -> 6227 bytes
 3 files changed, 83 insertions(+), 13 deletions(-)
 delete mode 100755 vspc_backup_checks/2.3/vspc_backup_checks-0.4.0.mkp
 create mode 100755 vspc_backup_checks/2.3/vspc_backup_checks-0.5.0.mkp

diff --git a/vspc_backup_checks/2.3/local/lib/python3/cmk_addons/plugins/vspc_backup_checks/libexec/agent_vspc_backup_checks b/vspc_backup_checks/2.3/local/lib/python3/cmk_addons/plugins/vspc_backup_checks/libexec/agent_vspc_backup_checks
index e58ccc9..d083213 100755
--- a/vspc_backup_checks/2.3/local/lib/python3/cmk_addons/plugins/vspc_backup_checks/libexec/agent_vspc_backup_checks
+++ b/vspc_backup_checks/2.3/local/lib/python3/cmk_addons/plugins/vspc_backup_checks/libexec/agent_vspc_backup_checks
@@ -12,6 +12,9 @@ CRIT = 2
 
 SECONDS_PER_DAY = 24 * 60 * 60
 
+DAILY  = "Daily"
+WEEKLY = "Weekly"
+
 
 # GET HTTP with Bearer auth. Returns data structure parsed from JSON.
 #
@@ -121,7 +124,7 @@ def parse_arguments():
 #     ],
 #     ...
 # }
-def process(mAgents, bAgents, jobs, restores):
+def process(mAgents, bAgents, jobs, restores, policies):
     mToB = {}
     for agent in bAgents:
         mToB[agent["managementAgentUid"]] = agent
@@ -139,12 +142,12 @@ def process(mAgents, bAgents, jobs, restores):
     # for every (backup agent ID, job ID) pair.
     bToR = defaultdict(dict)
     for r in restores:
-      bId = r["backupAgentUid"]
-      jId = r["jobUid"]
+        bId = r["backupAgentUid"]
+        jId = r["jobUid"]
 
-      most_recent = bToR[bId].get(jId)
-      if not most_recent or most_recent["creationDate"] < r["creationDate"]:
-          bToR[bId][jId] = r
+        most_recent = bToR[bId].get(jId)
+        if not most_recent or most_recent["creationDate"] < r["creationDate"]:
+            bToR[bId][jId] = r
 
     results = defaultdict(list)
     for mAgent in mAgents:
@@ -194,6 +197,7 @@ def process(mAgents, bAgents, jobs, restores):
             jobId = job["instanceUid"]
             last  = job["lastEndTime"]
             sched = job["scheduleType"]
+            polId = job["backupPolicyUid"]
 
             daysSinceLastRun = None
             if last:
@@ -222,12 +226,24 @@ def process(mAgents, bAgents, jobs, restores):
 
             warnDays = 0
             critDays = 0
-            if sched == "Daily":
-                # We use 1.2 & 2.2 here to give wiggle room for jobs to complete if
-                # they take longer than expected.
-                warnDays = 1.2
-                critDays = 2.2
-            elif sched == "Weekly":
+            if sched == DAILY:
+                policyType = policies.get(polId)
+                if policyType == WEEKLY:
+                    # It may seem silly to check for WEEKLY under a DAILY section,
+                    # but the scheduling allows for this, and we actually use this
+                    # in prod due to backups being performed on a specific day in
+                    # the week.
+                    #
+                    # We use 7.2 & 8.2 here to give wiggle room for jobs to
+                    # complete if they take longer than expected.
+                    warnDays = 7.2
+                    critDays = 8.2
+                else:
+                    # We use 1.2 & 2.2 here to give wiggle room for jobs to
+                    # complete if they take longer than expected.
+                    warnDays = 1.2
+                    critDays = 2.2
+            elif sched == WEEKLY:
                 # Ditto, but for a week
                 warnDays = 7.2
                 critDays = 8.2
@@ -288,6 +304,54 @@ def process(mAgents, bAgents, jobs, restores):
     return results
 
 
+# Alas, although VSPC's job data does specify whether a job runs "daily", it
+# does not tell you which days. Veeam allows "daily" jobs to be configured to
+# run on specific days of the week, which is something we use in production to
+# run certain backup jobs only on a Saturday.
+#
+# So we need to filter through VSPC's somewhat inconsistent policy API to find
+# daily settings. If a job is supposed to run on exactly one day a week, we
+# treat it as weekly, otherwise daily.
+#
+# NB: if we ever use more than one day during the week (e.g. two), the logic in
+# this plugin will need to be changed. The logic here, and in process() above,
+# match what we currently do in prod, since a "better" approach will require a
+# lot more code for a system we might phase out for something else.
+def mergePolicies(linuxPolicies, windowsPolicies, macPolicies):
+    policies = {}
+    schedules = {}
+
+    for policy in linuxPolicies + macPolicies:
+        schedule = policy["jobConfiguration"]["scheduleSettings"]
+        schedules[policy["instanceUid"]] = schedule
+
+    for policy in windowsPolicies:
+        config = policy["jobConfiguration"]
+
+        workstationSched = config.get("workstationModeSettings")
+        serverSched      = config.get("serverModeSettings")
+        schedule = workstationSched or serverSched
+        if not schedule:
+            continue
+        schedule = schedule["scheduleSetting"]
+        schedule = schedule.get("periodicalScheduleSettings") or schedule
+
+        schedules[policy["instanceUid"]] = schedule
+
+    for polId, sched in schedules.items():
+        dailySched = sched.get("dailyScheduleSettings")
+        if not dailySched:
+            continue
+
+        days = dailySched.get("specificDays")
+        if days and len(days) == 1:
+            policies[polId] = WEEKLY
+        else:
+            policies[polId] = DAILY
+
+    return policies
+
+
 def print_demo():
     print("""
 <<<<newveeam>>>>
@@ -337,12 +401,18 @@ def main(argv=None):
     if args.demo:
         return print_demo()
 
+    linuxPolicies   = get_paginated_json_url(args.hostname, args.port, '/api/v3/configuration/backupPolicies/linux',   args.token, args.insecure)
+    windowsPolicies = get_paginated_json_url(args.hostname, args.port, '/api/v3/configuration/backupPolicies/windows', args.token, args.insecure)
+    macPolicies     = get_paginated_json_url(args.hostname, args.port, '/api/v3/configuration/backupPolicies/mac',     args.token, args.insecure)
+
     mAgents  = get_paginated_json_url(args.hostname, args.port, '/api/v3/infrastructure/managementAgents',  args.token, args.insecure)
     bAgents  = get_paginated_json_url(args.hostname, args.port, '/api/v3/infrastructure/backupAgents',      args.token, args.insecure)
     jobs     = get_paginated_json_url(args.hostname, args.port, '/api/v3/infrastructure/backupAgents/jobs', args.token, args.insecure)
     restores = get_paginated_json_url(args.hostname, args.port, '/api/v3/protectedWorkloads/computersManagedByConsole/restorePoints', args.token, args.insecure)
 
-    results = process(mAgents, bAgents, jobs, restores)
+    policies = mergePolicies(linuxPolicies, windowsPolicies, macPolicies)
+
+    results = process(mAgents, bAgents, jobs, restores, policies)
     print_out(results)
 
 
diff --git a/vspc_backup_checks/2.3/vspc_backup_checks-0.4.0.mkp b/vspc_backup_checks/2.3/vspc_backup_checks-0.4.0.mkp
deleted file mode 100755
index 362eb09830248d42cda85ba463277cbf7adf2326..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5256
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
O%l`r2{Zm%}cmM$NhBFxe

diff --git a/vspc_backup_checks/2.3/vspc_backup_checks-0.5.0.mkp b/vspc_backup_checks/2.3/vspc_backup_checks-0.5.0.mkp
new file mode 100755
index 0000000000000000000000000000000000000000..700bd739b85bfc9bd0cfdb88f6a6a951e4358d45
GIT binary patch
literal 6227
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
V{{P3^)iZi#7U(x82NVJT{|8x--faK?

literal 0
HcmV?d00001