Veeam-Backup-Check-Referenz

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

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 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 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. Für Microsoft-365-Sicherungen nutze den Veeam Backup for Microsoft 365-Check auf dem Veeam-M365-Server.

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. Der Text nach dem Doppelpunkt ist die ursprüngliche Fehlermeldung von Veeam und benennt die tatsächliche Ursache
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
Veeam query returned no output. / Veeam query returned unreadable output.	Die Abfrage lief durch, lieferte aber nichts, was der Check lesen konnte. Die Veeam-Installation oder der PowerShell-Host auf dem Gerät hat keine verwertbaren Daten zurückgegeben — führe den Check erneut aus und prüfe bei Wiederholung die Voraussetzungen oben

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

Bei Agent-Sicherungsrichtlinien, die Veeam als ManagedByAgent verwaltet, erscheint jeder Computer separat als Richtlinie — Computer. So kann ein erfolgreicher Computer einen fehlgeschlagenen anderen Computer nicht verdecken. Für Auf bestimmte Auftragsnamen beschränken (optional) verwende weiterhin den Namen der übergeordneten Richtlinie, nicht den zusammengesetzten Anzeigenamen. Hat ein Computer noch keine Sitzung, gilt er als nie gelaufen; dafür greift Bei nie gelaufenen Aufträgen warnen. Die Richtlinien sind über Agent-Aufträge einbeziehen standardmäßig eingeschlossen.

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. Werte unter 10 werden auf 10 angehoben; 0 oder kleiner fällt auf 120 zurück. Nur sichtbar, wenn Erweiterte Optionen anzeigen aktiviert ist
Erfolgreiche Aufträge älter als Schwellenwerte melden	boolean	Nein	Ein (neue Zuweisungen)	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	Zeitplanbasiert (aus Auftragszeitplan)	Leitet die Altersgrenzen aus dem Auftragszeitplan ab. Wähle Manuell (feste Stunden) für feste Grenzen. 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

Bestehende Zuweisungen und Überschreibungen behalten ihre bisherigen Altersprüfungs-Einstellungen; die Standards oben gelten für neue Zuweisungen.

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
Ein überwachter Auftrag meldet ein letztes Ergebnis, das octoja nicht kennt	Warnung
Ein überwachter Auftrag läuft gerade — er wird aufgeführt, seine Sitzung aber erst nach dem Ende bewertet	OK
Ein Auftrag ist deaktiviert und Deaktivierte Aufträge bewerten ist aus	OK
Alle überwachten Aufträge wurden erfolgreich abgeschlossen	OK

Der Check meldet den schlechtesten Schweregrad über alle überwachten Aufträge.

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). Ein Auftrag, der erfolgreich war, aber eine Altersgrenze überschritten hat, behält seinen Status Erfolgreich und wird im Check-Detail des Geräts als Veraltet gekennzeichnet
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
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.
Ist im Modus Manuell der Wert Warnung nach (Stunden) höher gesetzt als Kritisch nach (Stunden), werden die beiden Werte vor der Bewertung getauscht.
Im Modus Zeitplanbasiert ergibt sich das erwartete Intervall aus dem Veeam-Zeitplan des Auftrags: Ein periodischer Zeitplan nutzt seine Periode, ein täglicher Zeitplan 24 Stunden — oder den längsten Abstand zwischen den ausgewählten Wochentagen — und ein monatlicher Zeitplan 31 Tage. Aufträge, deren Zeitplan sich nicht auslesen lässt, etwa fortlaufende und nur bei Bedarf gestartete Aufträge, werden nicht auf ihr Alter geprüft.
Dieser Check liest ausschließlich Veeam Backup & Replication. Für andere Backup-Produkte stellt octoja eigene Checks bereit: Windows-Sicherung für die native Windows-Server-Sicherung sowie Acronis Backup, Altaro Backup, Arcserve UDP, Comet Backup, Cove Backup, NAKIVO Backup & Replication, Synology Backup, TERRA CLOUD Backup und Xopero Backup.
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