Veeam-Backup-Check-Referenz

Alle Konfigurationsfelder, Alarmschwellenwerte und Plattformunterstützung für den Veeam-Backup-Check in octoja.

Geschrieben von Erdinc Akay

Zuletzt aktualisiert Vor 25 Tagen

Veeam-Backup-Check-Referenz

Konfigurationsoptionen und Alarmverhalten für den Veeam Backup & Replication-Check.

Der Veeam Backup & Replication-Check überwacht die Aufträge, die auf einem Veeam Backup & Replication-Server laufen. Er wird standardmäßig stündlich auf dem octoja-Agenten ausgeführt, der auf dem Veeam-Server installiert ist, fragt die lokale Veeam-Installation nach der letzten Sitzung jedes Auftrags ab und meldet das letzte Ergebnis und Alter jedes Auftrags an octoja zurück. Er deckt Backup-, Backup-Copy-, Agent- und Tape-Auftragstypen ab (Agent-Aufträge sind standardmäßig einbezogen, Tape-Aufträge sind optional), gesteuert über den Auftragstyp-Filter unten.

Welcher Veeam-Check für welches Veeam-Produkt?

octoja stellt zwei getrennte Veeam-Checks bereit. Sie lesen unterschiedliche Datenquellen — ein Check am falschen Veeam-Produkt schlägt dauerhaft fehl, obwohl in Veeam alle Aufträge grün sind.

Dein Veeam-Produkt	Zuzuweisender Check
Veeam Backup & Replication (zentraler Backup-Server)	Veeam Backup & Replication-Check — dieser Artikel, auf dem Veeam-Server selbst
Veeam Agent for Windows, eigenständig (z. B. Sicherung auf eine lokale USB-Festplatte)	Veeam Backup Agent-Check — siehe Veeam-Agent-Check – Referenz, auf dem Endpunkt, auf dem der Agent läuft

Leitsymptom einer falschen Zuweisung: Der Check meldet fehlgeschlagen, obwohl in Veeam alle Aufträge grün sind. Prüfe, welcher der beiden Checks dem Gerät zugewiesen ist — auch bei tag-basierter Zuweisung: Ein automatisches Tag kann diesen Check an ein Gerät hängen, das nur Veeam Agent for Windows ausführt. Agent-Aufträge, die ein Backup & Replication-Server verwaltet, deckt dieser Check auf dem Server ab (Option Agent-Aufträge einbeziehen); der Veeam Backup Agent-Check ist nur für eigenständige Installationen.

Voraussetzungen

Der octoja-Agent ist auf dem Veeam Backup & Replication-Server selbst installiert. Der Check fragt ausschließlich die lokale Veeam-Installation ab — einen entfernten Veeam-Server kann er nicht überwachen.
Das Veeam-PowerShell-Modul ist vorhanden. Es wird zusammen mit Veeam Backup & Replication installiert; der Check findet es auch, wenn das Modul nicht im PowerShell-Modulpfad registriert ist.
Der Veeam Backup Service läuft auf dem Gerät. Der Check meldet sich am Veeam-Server auf derselben Maschine (localhost) an und listet dessen Aufträge auf.
Der Check meldet sich mit dem Windows-Konto an, unter dem der octoja-Agent-Dienst läuft — separate Veeam-Anmeldedaten sind weder erforderlich noch konfigurierbar. Dieses Konto muss Aufträge auf dem Veeam-Server abfragen dürfen.

Wenn der Check selbst nicht laufen kann, meldet er einen dieser Fehler:

Fehlermeldung	So liest du sie
Veeam Backup & Replication PowerShell module not found on this device.	Das Veeam-PowerShell-Modul ließ sich nicht laden. Das Gerät ist in der Regel kein Veeam Backup & Replication-Server — es sichert z. B. mit Veeam Agent for Windows. Weise stattdessen den Veeam Backup Agent-Check zu (siehe oben)
Could not connect to the local Veeam Backup service.	Das Modul wurde geladen, aber der Check konnte sich an keinem Veeam-Server auf dieser Maschine anmelden. Typische Ursachen: Das Gerät ist nicht der Backup & Replication-Server selbst (z. B. ist nur die Veeam-Konsole oder Veeam Agent for Windows installiert — laufende Veeam-Dienste und ein installiertes PowerShell-Modul reichen dafür nicht aus); der Veeam Backup Service ist gestoppt; oder das Windows-Konto des octoja-Agenten ist auf dem Veeam-Server nicht berechtigt
Veeam query timed out after …	Das Aufzählen der Aufträge dauerte länger als das Abfrage-Timeout. Erhöhe Abfrage-Timeout (Sekunden) in den erweiterten Optionen

Unterstützte Veeam-Versionen

Der Check unterstützt Veeam Backup & Replication v12 (das Veeam-Modul läuft in Windows PowerShell) und v13 (das Modul läuft in PowerShell 7, pwsh); den passenden PowerShell-Host wählt der Check automatisch.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Alle Auftragstypen überwachen	boolean	Nein	Aus	Jeden Auftrag unabhängig vom Typ bewerten, statt nur die ausgewählten Typen. Deaktivieren, um die Überwachung auf bestimmte Auftragstypen zu beschränken
Zu überwachende Auftragstypen	Liste von Zeichenketten	Nein	Backup, BackupCopy	Einzubeziehende Veeam-Auftragstypen (z. B. Backup, BackupCopy). Nur sichtbar, wenn Alle Auftragstypen überwachen deaktiviert ist
Agent-Aufträge einbeziehen	boolean	Nein	Ein	Auch von VBR verwaltete Agent-Backup-Aufträge bewerten
Tape-Aufträge einbeziehen	boolean	Nein	Aus	Auch Tape-Backup-Aufträge bewerten
Bei nie gelaufenen Aufträgen warnen	boolean	Nein	Ein	Aufträge ohne bisher abgeschlossene Sitzung als Warnung melden. Deaktivieren, um nie gelaufene Aufträge zu ignorieren
Deaktivierte Aufträge bewerten	boolean	Nein	Aus	Wenn aus, werden deaktivierte Aufträge aufgeführt, lösen aber nie Alarm aus
Erweiterte Optionen anzeigen	boolean	Nein	Aus	Blendet die folgenden erweiterten Felder ein (Auftragsnamen-Filter, Abfrage-Timeout und Backup-Alter-Schwellenwerte)
Auf bestimmte Auftragsnamen beschränken (optional)	Liste von Zeichenketten	Nein	—	Leer lassen, um alle passenden Aufträge zu überwachen; andernfalls werden nur diese Auftragsnamen bewertet. Müssen mit den Namen aus der Veeam Backup & Replication-Konsole übereinstimmen. Nur sichtbar, wenn Erweiterte Optionen anzeigen aktiviert ist
Abfrage-Timeout (Sekunden)	Zahl	Nein	120	Maximale Wartezeit, bis Veeam seine Aufträge aufzählt. Auf Servern mit umfangreicher Backup-Historie erhöhen, falls die Prüfung ein Timeout meldet. Nur sichtbar, wenn Erweiterte Optionen anzeigen aktiviert ist
Erfolgreiche Aufträge älter als Schwellenwerte melden	boolean	Nein	Aus	Erfolgreiche Aufträge als Warnung/Kritisch markieren, wenn der letzte Erfolg zu alt ist. Nur sichtbar, wenn Erweiterte Optionen anzeigen aktiviert ist
Modus Altersschwelle	radio	Nein	Manuell (feste Stunden)	Wähle Manuell (feste Stunden), um die Altersgrenzen selbst festzulegen, oder Zeitplanbasiert (aus Auftragszeitplan), um die Grenze jedes Auftrags aus seinem eigenen Zeitplan abzuleiten, sodass nicht täglich laufende Aufträge (z. B. wöchentlich/monatlich) nicht in jedem Zyklus gemeldet werden. Nur sichtbar, wenn Erfolgreiche Aufträge älter als Schwellenwerte melden aktiviert ist
Warnung nach (Stunden)	Zahl	Nein	50	Stunden seit dem letzten erfolgreichen Backup bis zur Warnung. Nur im Modus Manuell sichtbar
Kritisch nach (Stunden)	Zahl	Nein	80	Stunden seit dem letzten erfolgreichen Backup bis zum kritischen Alarm. Nur im Modus Manuell sichtbar
Karenzzeit (Stunden)	Zahl	Nein	12	Zusätzliche Zeit über das eigene Intervall des Auftrags hinaus vor der Warnung, um Laufzeit und Zeitplan-Schwankungen abzufangen. Eine Warnung erfolgt nach einem verpassten Intervall plus dieser Karenz, Kritisch nach zwei. Nur im Modus Zeitplanbasiert sichtbar

Alarmverhalten

Bedingung	Schweregrad
Letztes Auftragsergebnis ist Fehlgeschlagen	Kritisch
Letztes Auftragsergebnis ist Warnung	Warnung
Letztes erfolgreiches Backup ist älter als der kritische Schwellenwert (nur wenn Erfolgreiche Aufträge älter als Schwellenwerte melden aktiviert ist)	Kritisch
Letztes erfolgreiches Backup ist älter als der Warnschwellenwert (nur wenn Erfolgreiche Aufträge älter als Schwellenwerte melden aktiviert ist)	Warnung
Ein überwachter Auftrag ist nie gelaufen (nur wenn Bei nie gelaufenen Aufträgen warnen aktiviert ist)	Warnung
Keine passenden Aufträge gefunden, oder keiner der genannten Aufträge existiert	Warnung
Alle überwachten Aufträge wurden erfolgreich abgeschlossen	OK

Erfasste Metriken

Für jeden überwachten Auftrag meldet der Check:

Auftragsname und Auftragstyp
Status des letzten Laufs (Erfolgreich, Warnung, Fehlgeschlagen, Nie gelaufen, Läuft, Deaktiviert oder Unbekannt)
Zeitstempel des letzten Laufs und Startzeit
Sitzungszustand (z. B. Läuft, Leerlauf, Nachbearbeitung) und Fortschritt in Prozent während der Ausführung
Backup-Typ (Vollständig, Aktives Voll oder Inkrementell), ob der Zeitplan aktiviert ist, Komprimierungsstufe, VSS, Verschlüsselung, dominanter Engpass (Quelle, Proxy, Netzwerk oder Ziel) und ob das letzte Ergebnis aus einer Wiederholung stammt
Fehler- oder Warnungsgrund aus dem Veeam-Sitzungsprotokoll, sofern vorhanden
Berechneter Schweregrad (OK, Warnung, Kritisch oder Fehler) basierend auf dem letzten Status und den konfigurierten Altersgrenzen. Fehlgeschlagene Aufträge und Überschreitungen der kritischen Altersgrenze werden beide als Kritisch gemeldet; der Schweregrad Fehler deckt Fälle ab, in denen der Check selbst nicht laufen kann — das Veeam-PowerShell-Modul lässt sich nicht laden, die Abfrage läuft in ein Timeout oder liefert keine verwertbare Ausgabe, oder ein unerwarteter Fehler tritt auf.
Über alle Aufträge hinweg meldet der Check außerdem die Gesamtzahl der Aufträge, die Anzahl je Kategorie (fehlgeschlagen, Warnung, nie gelaufen, laufend, deaktiviert) und das Alter des letzten erfolgreichen Backups.

Plattformunterstützung

Plattform	Unterstützt
Windows Server	Ja
Windows Desktop	Nein
Linux	Nein
macOS	Nein

Hinweise

Der Check läuft alle 60 Minuten auf dem Agenten. Das Intervall ist nicht konfigurierbar.
Der Agent liest Backup-Daten über das lokale Veeam-PowerShell-Modul aus (wird mit Veeam Backup & Replication installiert). Eine REST-API-Konfiguration oder separate Veeam-Anmeldedaten sind nicht erforderlich.
Der Agent erkennt den PowerShell-Host automatisch: Zuerst wird pwsh versucht (erforderlich für Veeam 13+), und Windows PowerShell (powershell.exe) wird als Fallback verwendet, wenn das Veeam-Modul in pwsh nicht geladen werden kann. Veeam-Umgebungen mit gemischten Versionen funktionieren ohne weitere Konfiguration.
Der Check bewertet die letzte Sitzung jedes Auftrags. Deaktivierte Aufträge werden aufgeführt, lösen aber nur dann Alarm aus, wenn Deaktivierte Aufträge bewerten aktiviert ist, und ein Auftrag ohne bisher abgeschlossene Sitzung löst nur dann eine Warnung aus, wenn Bei nie gelaufenen Aufträgen warnen aktiviert ist.
Dieser Check überwacht keine Backup-Lösungen von Drittanbietern. Nutze für native Windows-Server-Sicherungen den Windows-Backup-Check, oder wende dich für andere Backup-Produkte an den octoja-Support.
Wenn du mehrere Veeam-Server betreibst, installiere den octoja-Agenten auf jedem und konfiguriere einen separaten Veeam Backup & Replication-Check auf jedem Gerät.

Siehe auch: Veeam-Backup-Check konfigurieren