Veeam-Agent-Check – Referenz

Alle Konfigurationsfelder, Schwellenwerte und Ergebniszustände des Veeam-Agent-Backup-Checks in octoja.

Veeam-Agent-Check – Referenz

Der Veeam Backup Agent-Check (kurz „Veeam-Agent-Check“) läuft auf dem octoja-Agenten, der auf einem Windows-Endpunkt installiert ist, und liest die Ergebnisse von Veeam Agent for Windows aus dem Windows-Ereignisprotokoll aus. Er meldet für jeden Backup-Auftrag das Ergebnis und das Alter sowie den Lizenzstatus. Er unterscheidet sich vom Veeam Backup & Replication-Check, der auf dem zentralen Veeam Backup & Replication-Server läuft.

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 Agent for Windows, eigenständig (z. B. Sicherung auf eine lokale USB-Festplatte)	Veeam Backup Agent-Check — dieser Artikel, auf dem Endpunkt, auf dem der Agent läuft
Veeam Backup & Replication (zentraler Backup-Server)	Veeam Backup & Replication-Check — siehe Veeam-Backup-Check-Referenz, auf dem Veeam-Server selbst

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 den falschen Veeam-Check an ein Gerät hängen. Agent-Aufträge, die ein Backup & Replication-Server zentral verwaltet, überwacht der Veeam Backup & Replication-Check auf diesem Server; dieser Check hier deckt eigenständige Installationen ab, die in das lokale Veeam Agent-Ereignisprotokoll schreiben.

Konfigurationsfelder

Feld	Typ	Erforderlich	Standard	Beschreibung
Vorhandensein des Agenten voraussetzen	Schalter	Nein	Ein	Wenn aktiviert, ist ein Rechner ohne Veeam Agent Kritisch. Deaktiviere die Option, um Rechner durchzulassen, die ihn nicht ausführen
Lizenzereignisse auswerten	Schalter	Nein	Ein	Eine Warnung ausgeben, wenn im Zeitfenster ein Ereignis zu abgelaufener Lizenz oder Kulanzzeitraum auftritt
Warnung nach (Stunden)	Zahl	Nein	30	Eine Warnung ausgeben, wenn der letzte erfolgreiche Lauf eines Auftrags älter ist als dieser Wert. `0` deaktiviert die Option. Erweiterte Option
Kritisch nach (Stunden)	Zahl	Nein	50	Kritisch, wenn der letzte erfolgreiche Lauf eines Auftrags älter ist als dieser Wert. `0` deaktiviert die Option. Erweiterte Option
Rückblick im Ereignisprotokoll (Tage)	Zahl	Nein	14	Wie weit das Veeam-Agent-Ereignisprotokoll zurück gelesen wird. Wird automatisch verlängert, um den Schwellenwert für das kritische Alter abzudecken. Erweiterte Option

Ergebniszustände

Bedingung	Schweregrad
Veeam Agent fehlt und Vorhandensein des Agenten voraussetzen ist aktiviert	Kritisch
Kein abgeschlossener Backup-Auftrag im Rückblick-Zeitfenster	Kritisch
Der letzte Lauf eines Auftrags endete mit einem Fehler	Kritisch
Der letzte erfolgreiche Lauf eines Auftrags ist älter als der kritische Schwellenwert	Kritisch
Der letzte Lauf eines Auftrags endete mit einer Warnung	Warnung
Der letzte erfolgreiche Lauf eines Auftrags ist älter als der Warnschwellenwert	Warnung
Ein Ereignis zu abgelaufener Lizenz oder Kulanzzeitraum liegt vor (wenn Lizenzereignisse ausgewertet werden)	Warnung
Der Check selbst konnte nicht ausgeführt werden — die Abfrage des Ereignisprotokolls hat das Zeitlimit überschritten, keine verwertbare Ausgabe geliefert oder ihr Ergebnis konnte nicht gelesen werden	Fehlgeschlagen
Die letzten Backups wurden innerhalb der Schwellenwerte erfolgreich abgeschlossen	OK

Das Gesamtergebnis ist das schlechteste Ergebnis pro Auftrag, mindestens auf Warnung angehoben, wenn ein Lizenzereignis vorliegt.

Erfasste Metriken

Pro Auftrag: Name, Zeitpunkt des letzten Laufs, Status (Erfolg, Warnung oder Fehler), Alter in Stunden und der berechnete Schweregrad (OK, Warnung oder Kritisch)
Das Alter des jüngsten erfolgreichen Backups über alle Aufträge hinweg
Die ID und das Datum des Lizenzereignisses, sofern ein Lizenzereignis vorliegt

Plattformunterstützung

Plattform	Unterstützt
Windows (Endpunkt mit Veeam Agent for Windows)	Ja
Linux	Nein
macOS	Nein

Hinweise

Der Check läuft alle 60 Minuten auf dem Agenten. Das Intervall ist nicht durch den Benutzer konfigurierbar.
Der Check erkennt Veeam Agent anhand seines Windows-Dienstes oder seines Veeam Agent-Ereignisprotokolls und liest dann die Ereignisse zu abgeschlossenen Aufträgen und zur Lizenz aus.
Wenn du den Warnschwellenwert höher als den kritischen Schwellenwert setzt, vertauscht der Check die beiden Werte vor der Auswertung.
Die Abfrage des Ereignisprotokolls hat ein Zeitlimit von 60 Sekunden. Dauert sie länger, meldet der Check Fehlgeschlagen statt eines Auftragsergebnisses.
Er benötigt keine Administratorrechte und keinen Netzwerkzugriff – er liest ausschließlich das lokale Ereignisprotokoll.

Siehe auch: Den Veeam-Agent-Check konfigurieren – die Schritt-für-Schritt-Anleitung zur Einrichtung.