Zum Hauptinhalt springen
Backup

Kopia Backup

Überwache mit dem Check Kopia Backup Alter, fehlgeschlagene Dateien und Status der Snapshot-Quellen eines Kopia-Servers über dessen API.

Der Check Kopia Backup überwacht die Snapshot-Quellen eines Kopia-Servers über dessen API: das Alter des letzten Snapshots jeder Quelle, fehlgeschlagene Dateien, unvollständige oder pausierte Snapshots und die Verbindung des Servers zum Repository. Er läuft alle 60 Minuten auf einem octoja-Agenten unter Windows, Linux oder macOS (x64 und Arm64), der den Kopia-Server erreicht, und liest ausschließlich.

Voraussetzungen

  • Ein Kopia-Server, der mit kopia server start und festen Zugangsdaten läuft. Die Desktop-App KopiaUI verwendet zufällige Einmalpasswörter und lässt sich nicht überwachen.
  • Zugangsdaten eines dieser beiden Benutzer des Servers:
    • der Server-Benutzer (--server-username, Standard kopia, mit --server-password), oder
    • der Server-Control-Benutzer (--server-control-username, Standard server-control, mit --server-control-password).
  • Der ausführende Agent erreicht den Kopia-Server am konfigurierten Port (Standard 51515).
  • Läuft der Kopia-Server auf einem anderen Gerät als der Agent, ist TLS (https) nötig. Unverschlüsseltes http akzeptiert der Check nur für dieses Gerät (localhost), weil die Zugangsdaten sonst unverschlüsselt übertragen würden.

Schritte

Schritt 1 – Kopia-Server vorbereiten

Starte den Kopia-Server mit festen Zugangsdaten, also mit --server-username und --server-password oder mit --server-control-username und --server-control-password. Für TLS übergibst du ein eigenes Zertifikat mit --tls-cert-file und --tls-key-file oder lässt Kopia mit --tls-generate-cert ein selbstsigniertes Zertifikat erzeugen. Bei einem selbstsignierten Zertifikat kopierst du den Fingerabdruck, den Kopia beim Start als SERVER CERT SHA256 ausgibt; du trägst ihn im Check ein.

Überwacht der Agent einen Kopia-Server auf demselben Gerät, genügt die Adresse 127.0.0.1 ohne TLS.

Schritt 2 – Check in octoja hinzufügen

  1. Gehe zu Geräte und öffne das Gerät, dessen Agent den Kopia-Server erreicht.
  2. Klicke auf den Tab Checks → Check hinzufügen → Kopia Backup.
  3. Trage unter Kopia-Server-Host den Hostnamen oder die IP-Adresse ein, z. B. 127.0.0.1 für dieses Gerät oder kopia.example.com, und prüfe Port.
  4. Lass TLS verwenden (https) aktiviert, außer der Server läuft auf diesem Gerät ohne TLS.
  5. Trage Benutzername und Passwort ein.
  6. (Optional) Trage bei einem selbstsignierten Zertifikat den SHA-256-Zertifikatsfingerabdruck ein.
  7. Passe bei Bedarf Warnung nach (Stunden) und Kritisch nach (Stunden) an und klicke auf Check hinzufügen.

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

Ist der Kopia-Server bereits als agentenloses Netzwerkgerät in octoja angelegt, füge den Check stattdessen auf diesem Gerät hinzu. octoja übernimmt die Adresse aus der IP des Geräts, und der als Überwachungsgerät hinterlegte Agent führt den Check aus. Da die IP nicht localhost ist, brauchst du dafür TLS. Siehe Ein Netzwerkgerät ohne Agent hinzufügen.

Einstellungen

FeldTypErforderlichStandardBeschreibung
Kopia-Server-HostZeichenketteJa—Hostname oder IP des Kopia-Servers, z. B. 127.0.0.1 für dieses Gerät. IPv6-Adressen sind ohne eckige Klammern möglich
PortGanzzahlJa51515Port des Kopia-Servers, 1 bis 65535
TLS verwenden (https)booleanNeinEinVerbindet per https. Unverschlüsseltes http ist nur für dieses Gerät (localhost) erlaubt
BenutzernameZeichenketteJakopiaServer-Benutzer (--server-username) oder Server-Control-Benutzer (--server-control-username). Darf keinen Doppelpunkt enthalten
PasswortPasswortJa—Passendes --server-password oder --server-control-password
SHA-256-ZertifikatsfingerabdruckZeichenketteNeinleerFingerabdruck eines selbstsignierten Serverzertifikats, wie Kopia ihn beim Start ausgibt (SERVER CERT SHA256). 64 Hexadezimalzeichen; Leerzeichen, Doppelpunkte und Bindestriche werden ignoriert. Leer lassen für die normale Zertifikatsprüfung
Warnung nach (Stunden)ZahlJa26Maximales Alter des letzten Snapshots jeder Quelle bis zur Warnung. Muss größer als 0 sein
Kritisch nach (Stunden)ZahlJa50Maximales Alter des letzten Snapshots jeder Quelle bis zum kritischen Alarm. Muss größer als 0 sein
Ausgeschlossene QuellenListe von ZeichenkettenNeinleerQuellen, deren benutzer@host:pfad einen dieser Einträge enthält, werden ignoriert. Groß- und Kleinschreibung spielt keine Rolle

Sind Warn- und kritischer Schwellenwert vertauscht, tauscht der Check sie automatisch.

Mit Fingerabdruck akzeptiert der Check nur das Zertifikat mit genau diesem SHA-256-Wert, und nur innerhalb seiner Gültigkeitsdauer. Die TLS-Prüfung wird nie deaktiviert.

Ergebnisse

Der Check bewertet jede Snapshot-Quelle einzeln. Die Quelle mit dem schlechtesten Ergebnis bestimmt den Gesamtstatus und erscheint in der Kurzmeldung.

Je Quelle

BedingungMeldungSchweregrad
Kopia meldet für die Quelle den Status FAILEDKopia kann Snapshots oder Richtlinie dieser Quelle nicht lesenKritisch
Für die Quelle gibt es noch keinen SnapshotKein Snapshot vorhandenKritisch
Der letzte Snapshot hat Kritisch nach (Stunden) erreichtLetzter Snapshot ist zu altKritisch
Der letzte Snapshot hat Warnung nach (Stunden) erreichtLetzter Snapshot ist zu altWarnung
Snapshots der Quelle sind pausiert (PAUSED)Snapshots sind pausiertWarnung
Der letzte Snapshot ist unvollständigLetzter Snapshot ist unvollständigWarnung
Im letzten Snapshot sind Dateien fehlgeschlagen; die Anzahl steht in KlammernDateien im letzten Snapshot fehlgeschlagenWarnung
Keine der Bedingungen trifft zu—OK

Das Alter misst der Check ab dem Ende des letzten Snapshots. Während ein Upload läuft, legt Kopia Zwischenstände (Checkpoints) an. Solange die Quelle dabei als hochladend oder als Remote-Client gemeldet wird, zählt ein solcher Checkpoint nicht als unvollständig. Bleibt der Upload eines Remote-Clients hängen, meldet der Check das erst über das Alter.

Für den gesamten Check

BedingungMeldungSchweregrad
Eine Einstellung ist ungültig, z. B. ein ungültiger Host, http zu einem anderen Gerät, ein leeres Passwort oder ein Fingerabdruck mit falscher LängeUngültige Konfiguration. Prüf URL, Zugangsdaten, Zertifikatsfingerabdruck und Schwellenwerte.Fehler
Kopia lehnt Benutzername oder Passwort ab (HTTP 401)Kopia hat Benutzername oder Passwort abgelehnt.Fehler
Der Benutzer ist weder Server-Benutzer noch Server-Control-Benutzer (HTTP 403)Dieser Benutzer darf weder die Kopia-UI noch die Server-Control-API verwenden. Verwende den Server-Benutzer oder den Server-Control-Benutzer.Fehler
Der Kopia-Server ist mit keinem Repository verbundenDer Kopia-Server ist mit keinem Repository verbunden.Kritisch
Der Server ist nicht erreichbar, das Zertifikat wird nicht akzeptiert, die Anfrage dauert länger als 30 Sekunden oder die API antwortet mit einem anderen HTTP-Fehler. In Klammern folgt die Ursache, z. B. HTTP 500Der Kopia-Server ist nicht erreichbar.Fehler
Die API liefert eine Antwort, die der Check nicht lesen kannDer Kopia-Server hat eine unerwartete Antwort geliefert.Fehler
Der Server meldet keine Quellen, oder alle Quellen sind ausgeschlossenKeine Snapshot-Quellen gefunden.Warnung

Die ausführliche Meldung listet alle Quellen mit Schweregrad, benutzer@host:pfad und ihren Problemen auf, die schlechtesten zuerst.

Hinweise

  • Verbindet sich der Check als Server-Benutzer, nutzt er dieselbe API wie die Kopia-Weboberfläche. Als Server-Control-Benutzer liest er die Quellen über die Server-Control-API.
  • Auf einem Kopia-Repository-Server erscheinen auch die Quellen der verbundenen Clients, jeweils mit deren Benutzer und Host. Schließe Quellen, die du nicht überwachen willst, über Ausgeschlossene Quellen aus.
  • Der Check zählt derzeit nicht als Backup-Check in den Backup-Widgets der Berichte.

FAQ

Nein. KopiaUI verwendet zufällige Einmalpasswörter, die du nicht fest im Check hinterlegen kannst. Betreibe Kopia stattdessen als Server mit kopia server start und festen Zugangsdaten.

Prüfe, ob TLS verwenden (https) deaktiviert ist, während der Host nicht dieses Gerät ist. Unverschlüsseltes http ist nur für 127.0.0.1, ::1 oder localhost erlaubt. Prüfe außerdem, dass der Fingerabdruck genau 64 Hexadezimalzeichen hat und beide Schwellenwerte größer als 0 sind.

Trage den Fingerabdruck, den Kopia beim Start als SERVER CERT SHA256 ausgibt, unter SHA-256-Zertifikatsfingerabdruck ein. Erzeugst du das Zertifikat neu, trägst du den neuen Fingerabdruck ein; bis dahin meldet der Check, dass der Server nicht erreichbar ist.