Zum Hauptinhalt springen
Backup

Proxmox Backup Server

Überwache mit dem Check Proxmox Backup Server die Datastore-Belegung, das Alter der Backups je Backup-Gruppe, Backup-Tasks und Sync-Jobs über die PBS-API.

Der Check Proxmox Backup Server überwacht einen Proxmox Backup Server (PBS) über dessen HTTPS-API: die Speicherbelegung der Datastores, das letzte abgeschlossene Backup jeder Backup-Gruppe, die Backup-Tasks und die konfigurierten Sync-Jobs. Er meldet sich mit einem API-Token an und liest ausschließlich; er ändert nichts auf dem PBS. Der Check läuft alle 10 Minuten auf einem octoja-Agenten unter Windows, Linux oder macOS (x64 und Arm64), der den PBS über das Netzwerk erreicht.

Voraussetzungen

  • Der ausführende Agent erreicht die PBS-API per HTTPS, typischerweise auf Port 8007 (z. B. https://pbs.example.com:8007).
  • Das TLS-Zertifikat des PBS ist auf dem Gerät des Agenten vertrauenswürdig. Ein selbstsigniertes Zertifikat lässt die Anfrage scheitern, solange du nicht TLS-Zertifikatsfehler ignorieren (unsicher) aktivierst.
  • Ein PBS-Benutzer mit einem API-Token. Benutzer und Token benötigen jeweils eigene Berechtigungen, denn PBS wertet für ein Token nur die Schnittmenge aus Benutzer- und Token-Berechtigungen:
PfadRolle (mit Vererbung)Wofür
/AuditLiefert Sys.Audit auf /system/tasks (Backup-Tasks) und Datastore.Audit für jeden Datastore und Namespace
/remoteRemoteAuditLiefert Remote.Audit für die Sync-Jobs. Nur nötig, wenn Konfigurierte Sync-Jobs überwachen aktiviert ist. Die Rolle Audit enthält Remote.Audit nicht

Schritte

Schritt 1 – API-Token auf dem PBS anlegen

Du kannst Benutzer, Token und Berechtigungen in der PBS-Weboberfläche unter Configuration → Access Control anlegen oder auf der PBS-Shell mit proxmox-backup-manager. Beispiel für einen Benutzer monitor@pbs mit dem Token octoja:

proxmox-backup-manager user create monitor@pbs
proxmox-backup-manager user generate-token monitor@pbs octoja
proxmox-backup-manager acl update / Audit --auth-id monitor@pbs
proxmox-backup-manager acl update / Audit --auth-id 'monitor@pbs!octoja'
proxmox-backup-manager acl update /remote RemoteAudit --auth-id monitor@pbs
proxmox-backup-manager acl update /remote RemoteAudit --auth-id 'monitor@pbs!octoja'

generate-token gibt die Token-ID (monitor@pbs!octoja) und das Secret aus. Kopiere das Secret sofort; PBS zeigt es später nicht mehr an. Neue Berechtigungen werden mit Vererbung angelegt. Die beiden /remote-Zeilen brauchst du nur für die Sync-Job-Überwachung.

Schritt 2 – Check in octoja hinzufügen

  1. Gehe zu Geräte und öffne das Gerät, dessen Agent den PBS erreicht.
  2. Klicke auf den Tab Checks → Check hinzufügen → Proxmox Backup Server.
  3. Trage unter PBS-HTTPS-URL die Adresse mit Port ein, z. B. https://pbs.example.com:8007.
  4. Trage API-Token-ID (monitor@pbs!octoja) und API-Token-Secret ein.
  5. (Optional) Grenze unter Datastores (exakte Namen) die Überwachung auf einzelne Datastores ein und passe die Schwellenwerte an.
  6. Klicke auf Check hinzufügen.

Nach dem ersten Lauf siehst du das Ergebnis im Tab Checks des Geräts.

Einstellungen

FeldTypErforderlichStandardBeschreibung
PBS-HTTPS-URLZeichenketteJa—Adresse des PBS, z. B. https://pbs.example.com:8007. Nur https, ohne Pfad, Anmeldedaten, Query oder Fragment. Weiterleitungen folgt der Check nicht
API-Token-IDZeichenketteJa—Vollständige Token-ID im Format benutzer@realm!tokenname. Ohne ! gilt die Konfiguration als ungültig
API-Token-SecretPasswortJa—Secret des API-Tokens
TLS-Zertifikatsfehler ignorieren (unsicher)booleanNeinAusSchaltet die Zertifikatsprüfung ab. Aktiviere das nur in vertrauenswürdigen Testumgebungen
Zeitlimit für den gesamten Check (Sekunden)GanzzahlNein60Gesamtzeit für alle API-Abfragen eines Laufs. Erlaubt sind 1 bis 300
Datastores (exakte Namen)Liste von ZeichenkettenNeinleerLeer lassen, um alle zugänglichen Datastores zu überwachen. Namen müssen exakt übereinstimmen, einschließlich Groß- und Kleinschreibung
Speicherbelegung: Warnung (%)ZahlNein80Warnung, sobald die Belegung eines Datastores diesen Wert erreicht. Erlaubt sind 0 bis 100
Speicherbelegung: kritisch (%)ZahlNein90Kritisch, sobald die Belegung eines Datastores diesen Wert erreicht. Erlaubt sind 0 bis 100
Alter abgeschlossener Backups: Warnung (Stunden)GanzzahlNein26Warnung, wenn das letzte abgeschlossene Backup einer Backup-Gruppe mindestens so alt ist. Mindestens 1
Alter abgeschlossener Backups: kritisch (Stunden)GanzzahlNein48Kritisch, wenn das letzte abgeschlossene Backup einer Backup-Gruppe mindestens so alt ist. Mindestens 1
Rückblick für Backup-Tasks (Stunden)GanzzahlNein48Zeigt den letzten abgeschlossenen Backup-Task je Worker innerhalb dieses Zeitraums sowie laufende Backup-Tasks. Erlaubt sind 1 bis 720
Konfigurierte Sync-Jobs überwachenbooleanNeinEinBewertet die Sync-Jobs der überwachten Datastores, sowohl Pull als auch Push. Benötigt Remote.Audit auf /remote

Sind Warn- und kritischer Schwellenwert vertauscht, wertet der Check den kleineren Wert als Warnung und den größeren als kritisch. Werte außerhalb der erlaubten Bereiche führen zu Ungültige Konfiguration.

Ergebnisse

Der Check bewertet jeden Datastore, jede Backup-Gruppe, jeden Backup-Task und jeden Sync-Job einzeln. Das schlechteste Einzelergebnis wird zum Gesamtstatus.

BedingungMeldungSchweregrad
Eine Einstellung ist ungültig, etwa eine http-URL, eine URL mit Pfad oder eine Token-ID ohne !Ungültige Konfiguration.Fehler
PBS lehnt das Token ab (HTTP 401/403), oder Sys.Audit auf /system/tasks fehlt, oder bei aktiver Sync-Überwachung fehlt Remote.Audit mit Vererbung auf /remoteZugriff verweigert. Prüfe Audit auf / und RemoteAudit auf /remote (Sync) für Benutzer und Token.Fehler
Einem Datastore oder einem seiner Namespaces fehlt Datastore.Audit (beim Datastore mit Vererbung)Zugriff verweigert. … (beim betroffenen Datastore)Fehler
PBS ist nicht erreichbar, das Zertifikat wird nicht akzeptiert, oder die API antwortet mit einem Fehler oder einer WeiterleitungPBS-API-Anfrage fehlgeschlagen.Fehler
Die API liefert Daten, die der Check nicht auswerten kann, z. B. ein Snapshot liegt mehr als 5 Minuten in der ZukunftUngültige PBS-API-Antwort.Fehler
Der Lauf überschreitet Zeitlimit für den gesamten Check (Sekunden). Bis dahin gelesene Daten werden trotzdem angezeigtZeitlimit für den gesamten Check überschritten.Fehler
Ein unter Datastores (exakte Namen) eingetragener Datastore existiert nicht oder ist für das Token nicht sichtbarAngeforderter Datastore fehlt oder ist nicht sichtbar.Fehler
Kein Datastore ist sichtbar und keiner ist eingetragenKeine zugänglichen Datastores gefunden.Warnung
Die Belegung eines Datastores erreicht den kritischen SchwellenwertSpeicherbelegung hat die kritische Schwelle erreicht.Kritisch
Die Belegung eines Datastores erreicht den WarnschwellenwertSpeicherbelegung hat die Warnschwelle erreicht.Warnung
Ein Datastore enthält keine sichtbare Backup-GruppeKeine sichtbaren Backup-Gruppen gefunden.Warnung
Eine Backup-Gruppe hat nur unvollständige SnapshotsKein abgeschlossenes Backup gefunden.Kritisch
Das letzte abgeschlossene Backup einer Gruppe erreicht den kritischen AltersschwellenwertLetztes abgeschlossenes Backup überschreitet die Altersgrenze.Kritisch
Das letzte abgeschlossene Backup einer Gruppe erreicht den WarnschwellenwertLetztes abgeschlossenes Backup überschreitet die Altersgrenze.Warnung
Ein Backup-Task oder Sync-Job endete mit OK oder läuft geradeOK bzw. Läuft (informativ)OK
Ein Backup-Task oder Sync-Job endete mit Warnungen (WARNINGS: n) oder ohne lesbaren StatusWarnungen: n bzw. UnbekanntWarnung
Ein Sync-Job wurde noch nie ausgeführtNoch nie ausgeführtWarnung
Ein Backup-Task oder Sync-Job endete mit einem FehlerFehlermeldung von PBSKritisch

Scheitert nur ein einzelner Datastore, prüft der Check die übrigen Datastores weiter.

So bewertet der Check Backups, Tasks und Sync-Jobs

  • Backup-Gruppen: Der Check durchsucht den Root-Namespace und alle Namespaces jedes Datastores. Eine Backup-Gruppe ist z. B. vm/100 oder ct/101. Als abgeschlossen gilt ein Snapshot, den PBS fertig geschrieben hat; das Alter misst der Check ab dem Zeitstempel des neuesten abgeschlossenen Snapshots.
  • Backup-Tasks: Je Worker zeigt der Check den letzten abgeschlossenen Backup-Task im Rückblickzeitraum sowie alle laufenden Backup-Tasks. Fehlt ein Worker im Rückblick, erscheint er nicht; für veraltete Backups ist die Altersprüfung der Backup-Gruppen zuständig.
  • Sync-Jobs: Der Check liest Pull- und Push-Sync-Jobs jedes überwachten Datastores und bewertet den Status des letzten Laufs.

Detailansicht

Die Detailansicht des Checks gliedert sich in diese Abschnitte, jeweils mit Schweregrad je Eintrag:

AbschnittInhalt
DatastoresBelegt in Prozent, Gesamt- und freier Speicher
Letztes abgeschlossenes Backup pro GruppeDatastore, Namespace (Wurzel für den Root-Namespace) und Zeitpunkt des letzten abgeschlossenen Backups
Backup-Tasks: letzter abgeschlossener je Worker im Rückblick + laufendeDatastore, Status, Start- und Endzeit
Konfigurierte Sync-JobsRichtung (Pull oder Push), Quell-Datastore, Remote- / Gegenstellen-Datastore, Remote (Lokal bei lokalen Sync-Jobs) und Endzeit des letzten Laufs

Hinweise

  • PBS zeigt nur, was das Token sehen darf. Eine leere Liste der Sync-Jobs kann bedeuten, dass keine Sync-Jobs sichtbar sind, nicht dass keine existieren. Prüfe in diesem Fall, ob Benutzer und Token die Rollen aus den Voraussetzungen haben.
  • Der Check liest nur die Backup-Daten des PBS. Den Zustand deiner Proxmox-VE-Hosts überwachst du mit den Checks Proxmox-Cluster und Quorum und Proxmox-Dienste & HA.
  • Der Check zählt derzeit nicht als Backup-Check in den Backup-Widgets der Berichte.

FAQ

Bei einem PBS-API-Token gilt immer die Schnittmenge aus den Berechtigungen des Benutzers und des Tokens. Weise die Rollen deshalb sowohl dem Benutzer (monitor@pbs) als auch dem Token (monitor@pbs!octoja) zu. Ist Konfigurierte Sync-Jobs überwachen aktiviert, brauchen beide zusätzlich RemoteAudit mit Vererbung auf /remote; ohne diese Berechtigung schlägt der gesamte Check fehl. Wenn du keine Sync-Jobs überwachen willst, deaktiviere die Option.

Prüfe, ob der Agent den PBS unter der eingetragenen Adresse und dem Port erreicht und ob das Zertifikat des PBS auf dem Gerät des Agenten vertrauenswürdig ist. PBS verwendet nach der Installation ein selbstsigniertes Zertifikat. Hinterlege ein vertrauenswürdiges Zertifikat auf dem PBS; nur in vertrauenswürdigen Testumgebungen solltest du TLS-Zertifikatsfehler ignorieren (unsicher) aktivieren.

Alte Gruppen, etwa von gelöschten VMs, bleiben auf dem PBS sichtbar, bis ihre Snapshots entfernt werden. Entferne nicht mehr benötigte Gruppen auf dem PBS. Sichert eine Gruppe seltener als täglich, erhöhe beide Altersschwellenwerte so, dass sie über dem Backup-Intervall liegen.