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:
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
- Gehe zu Geräte und öffne das Gerät, dessen Agent den PBS erreicht.
- Klicke auf den Tab Checks → Check hinzufügen → Proxmox Backup Server.
- Trage unter PBS-HTTPS-URL die Adresse mit Port ein, z. B.
https://pbs.example.com:8007. - Trage API-Token-ID (
monitor@pbs!octoja) und API-Token-Secret ein. - (Optional) Grenze unter Datastores (exakte Namen) die Überwachung auf einzelne Datastores ein und passe die Schwellenwerte an.
- Klicke auf Check hinzufügen.
Nach dem ersten Lauf siehst du das Ergebnis im Tab Checks des Geräts.
Einstellungen
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.
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/100oderct/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:
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
Warum meldet der Check „Zugriff verweigert“, obwohl der Benutzer Berechtigungen hat?
Warum meldet der Check „Zugriff verweigert“, obwohl der Benutzer Berechtigungen hat?
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.
Warum meldet der Check „PBS-API-Anfrage fehlgeschlagen“?
Warum meldet der Check „PBS-API-Anfrage fehlgeschlagen“?
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.
Eine Backup-Gruppe meldet dauerhaft „Letztes abgeschlossenes Backup überschreitet die Altersgrenze“. Was kann ich tun?
Eine Backup-Gruppe meldet dauerhaft „Letztes abgeschlossenes Backup überschreitet die Altersgrenze“. Was kann ich tun?
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.
War dies hilfreich?
Mehr in Backup
Acronis BackupAcronis Cyber Protect CloudAltaro BackupArcserve UDPBrauchen Sie noch Hilfe? Team fragen