Fehlererklärungen
Wenn in Restow etwas fehlschlägt, endet das nicht in einem nackten Fehlertext. Die Meldung sagt drei Dinge, in Ihrer Sprache: was passiert ist, warum und was zu tun ist, mit einem Link auf die Seite, auf der Sie es erledigen können. Dieselbe Erklärung erscheint überall, wo ein Fehler auftaucht, und die Ursache dahinter ist ein stabiler Code, den Ihre eigenen Werkzeuge lesen können.
Wo Sie sie sehen
Abschnitt betitelt „Wo Sie sie sehen“- Verlauf. Ein fehlgeschlagener oder teilweise fehlgeschlagener Lauf, zum Beispiel ein Backup, ein Restore oder eine Prüfung, unter Täglich → Verlauf. Die Seite des Laufs erklärt den Fehler des Laufs selbst und darunter die fehlgeschlagenen Elemente, nach Ursache gruppiert.
- Fehlgeschlagene Elemente. Elemente, die ein Lauf nicht verarbeiten konnte, sind unter Fehlgeschlagene Elemente nach Ursache gruppiert. Elemente mit gleicher Ursache stehen einmal mit ihrer Anzahl da, und das jüngste Beispiel jeder Gruppe ist erklärt.
- Quellen. Eine Quelle mit gestörter Verbindung nennt den Grund, zum Beispiel dass die Administratorzustimmung fehlt.
- Verzeichnisabgleich. Ein fehlgeschlagener Verzeichnisabgleich einer Quelle.
- IMAP-Anmeldetest. Ein fehlgeschlagener Anmeldetest eines IMAP-Kontos.
- Prüfung. Eine rote oder gelbe Wiederherstellbarkeitsprüfung erklärt jeden Grund, den sie gefunden hat (siehe Backup und Restore). Eine Prüfung, die nicht abgeschlossen werden konnte, ist kein Fehler der Sicherung: Sie zeigt Nicht abgeschlossen, wird wiederholt in neutralem Ton und, solange Versuche übrig sind, ihre Ursache.
- Server- und Client-Backups. Die Läufe eines Endpunkts erklären ihre Fehler auf dieselbe Weise (siehe Endpunkt-Backup).
So lesen Sie eine Erklärung
Abschnitt betitelt „So lesen Sie eine Erklärung“- Die Überschrift nennt die Ursache in einem Satz, zum Beispiel „Der Restow-App fehlt eine Microsoft-365-Berechtigung“.
- Was passiert ist. Was fehlgeschlagen ist, für welches Postfach, Laufwerk, welche Quelle oder welches Konto, und wann. Dazu der Schritt, in dem der Job stand, als er anhielt, und bei einem Lauf, wie viele Elemente betroffen waren.
- Warum. Der Grund in einfachen Worten, mit den Fakten des Falls: die fehlende Berechtigung, der Host, der sich nicht erreichen lässt, die Sekunden, die Microsoft Restow warten lassen wollte.
- Was zu tun ist. Nummerierte Schritte in der richtigen Reihenfolge. Ein Schritt, der auf eine andere Seite gehört, hat einen Link, der sie öffnet: Microsoft-365-Einstellungen öffnen, Quelle öffnen, Quellen öffnen, Geschützte Objekte öffnen, Repositories öffnen, Wiederherstellbarkeit öffnen oder Backup öffnen. Mehrere Schritte zur selben Seite verlinken sie einmal, beim ersten davon.
- Jetzt erneut versuchen. Eine Schaltfläche, die nur dort erscheint, wo ein neuer Versuch helfen kann, sobald Sie die Ursache behoben haben. Sie fehlt bei Ursachen, bei denen ein neuer Versuch immer gleich scheitern würde, bis sich etwas ändert (ein Benutzer, den es nicht mehr gibt, ein zu großes Element), und solange Restow es schon selbst erneut versucht.
- Anleitung zur Fehlersuche. Ein Link auf die Seite mit weiterer Hilfe (siehe unten).
- Technische Details. Ein eingeklappter Bereich für eine Supportanfrage (siehe unten).
Restow versucht es automatisch erneut
Abschnitt betitelt „Restow versucht es automatisch erneut“Viele Ursachen sind vorübergehend: Drosselung, ein kurzer Ausfall, eine abgebrochene Verbindung. Ein Job, der so fehlgeschlagen ist, wird von selbst wieder eingereiht. Die Erklärung erscheint dann als Warnung, sagt Restow versucht es automatisch erneut und zeigt den fehlgeschlagenen Versuch („Versuch x von y ist fehlgeschlagen. Restow versucht es etwa … erneut.“) mit dem Zeitpunkt des nächsten Versuchs. Sie beschreibt den früheren Versuch, und Sie müssen nichts tun, solange die Wiederholungen nicht aufgebraucht sind. Die Spalte Vorübergehend in den Tabellen unten zeigt, welche Ursachen so behandelt werden.
Technische Details
Abschnitt betitelt „Technische Details“Für eine Supportanfrage öffnen Sie Technische Details. Sie listen den Ursachencode, den Zeitpunkt und den Schritt auf, dazu, was der fehlgeschlagene Aufruf gemeldet hat, soweit es zutrifft:
- den HTTP-Status, den Graph-Fehlercode und den inneren Fehlercode, den Entra-Fehler (AADSTS) und die Korrelations-ID,
- die Request-ID, die Client-Request-ID und die Zeit laut Server (Serverzeit), nach denen der Microsoft-Support fragt,
- die Anfrage selbst (Methode und Pfad, ohne Query-String),
- bei IMAP: die Antwort des Servers, ihren Antwortcode, den Status und den Befehl,
- bei Netzwerk und System: den Host, den Port, den Systemaufruf, den Pfad, den SQL-Status der Datenbank.
Details für den Support kopieren legt die Liste in die Zwischenablage. Secrets werden entfernt, bevor etwas gespeichert wird: Passwörter, Schlüssel, Tokens, Authorization-Header, Zugangsdaten und Query-Strings in URLs sowie der Text einer fehlgeschlagenen Datenbankabfrage erscheinen nie in den Details.
Fehler ohne bekannte Ursache
Abschnitt betitelt „Fehler ohne bekannte Ursache“Ein Fehler, den Restow nicht einordnen kann, erhält die Ursache unknown. Er zeigt statt einer Erklärung die Meldung, wie sie gespeichert wurde (Secrets entfernt).
Sicherungen, die ein Dienst gebremst hat, und nicht gesicherte Objekte (seit 0.4.7)
Abschnitt betitelt „Sicherungen, die ein Dienst gebremst hat, und nicht gesicherte Objekte (seit 0.4.7)“Zwei Arten von Läufen enden ohne Sicherung, obwohl an der Sicherung selbst nichts falsch ist. Seit 0.4.7 zählt keine davon als Fehler.
Vom Dienst gebremst. Eine Mail-&-SaaS-Sicherung, die nach allen Wiederholungen mit graph.throttled, graph.service_unavailable oder storage.rate_limited endet, zeigt gelb Vom Dienst gedrosselt, wird wiederholt statt rot Fehlgeschlagen (in der Objektliste Vom Dienst gebremst), in jeder Ansicht: Verlauf, die Job-Übersicht über alle Mandanten, die Objektliste, die Läufe eines Jobs, die Job-Seite, die letzten Jobs im Dashboard und die Lauf-Details.
- Sie bleibt aus den Fehlerzählern der Statistik und des Dashboards heraus, macht den Job nicht fehlerhaft (der Lauf davor gilt), macht keine Warnung rot oder beendet ihre Bestätigung und löst weder eine Meldung Sicherung fehlgeschlagen noch einen Webhook
job.failedaus. - Der nächste geplante Lauf versucht es erneut. Ein Objekt, das länger gebremst bleibt, fangen die Regeln für überfällige Sicherungen und die Bereitschaft ab, die auf das Alter der neuesten Sicherung schauen, nicht auf einzelne Läufe.
- Eine Wiederherstellung, ein Export, ein Import oder eine Prüfung, die ein Dienst gebremst hat, hat keinen nächsten Lauf und bleibt ein Fehler, mit Wiederherstellung fehlgeschlagen und Ähnlichem.
- Die Zählung liest die zu jedem Lauf gespeicherte Ursache, sodass Läufe von vor dem Update, die mit diesen Ursachen endeten, genauso erscheinen und die Fehlerzähler vergangener Zeiträume verlassen.
Nicht gesichert. graph.mailbox_inactive, graph.object_locked und config.object_inactive sagen, dass das Objekt nicht gesichert wird, bis sein Konto wieder aktiviert oder lizenziert oder die Sperre aufgehoben ist. Der Lauf endet neutral, ohne Wiederholungen: Er zeigt Nicht gesichert: Konto deaktiviert, Nicht gesichert: keine Lizenz oder Nicht gesichert: gesperrt (auf der Job-Seite von Microsoft gesperrt), zählt weder als fehlgeschlagen noch als gebremst und löst weder eine Meldung Sicherung fehlgeschlagen noch einen Webhook job.failed aus. Vorhandene Sicherungen bleiben erhalten. Die Schritte sagen, was das Objekt zurückbringt: das Konto im Microsoft-365-Admin-Center aktivieren, eine Lizenz zuweisen (bei einem gesperrten OneDrive eine mit OneDrive) oder die Sperre einer Website im SharePoint Admin Center aufheben und dann den Verzeichnisabgleich laufen lassen; die Sicherung setzt von selbst wieder ein. Ein späterer Lauf auf ein schon markiertes Objekt wird mit config.object_inactive abgewiesen. Das Objekt selbst wartet auf die Bestätigung einer Administration, siehe Objekte, die nicht mehr gesichert werden.
In der Integrations-API behält GET /api/v1/jobs für beide Arten den Status failed, weil der Vertrag kein Feld hat, das sie unterscheidet: Lesen Sie failure.code (und das statusReason des Objekts) und behandeln Sie sie wie den Zustand des Objekts, nicht wie einen Fehler (Vertrag 1.7.0).
Der Link zur Fehlersuche
Abschnitt betitelt „Der Link zur Fehlersuche“Der Link Anleitung zur Fehlersuche zeigt standardmäßig auf die Seite zur Fehlersuche dieser Dokumentation. Führen Sie ein eigenes Runbook, setzen Sie RESTOW_DOCS_TROUBLESHOOTING_URL in der .env auf dessen Adresse. Es ist eine Adresse für die ganze Installation: Jede Erklärung in der Oberfläche und das Feld docsUrl der Integrations-API zeigen dann dorthin. Ein fehlender abschließender Schrägstrich wird ergänzt.
In der Integrations-API und in Webhooks
Abschnitt betitelt „In der Integrations-API und in Webhooks“Die Ursache ist Teil der Daten, die Ihre Integrationen schon lesen. Die Felder sind additiv: Sie werden nur hinzugefügt, nie umbenannt oder entfernt. Siehe Integrations-API.
- Job-Objekte enthalten
failure(die Ursache eines fehlgeschlagenen Jobs oder seines letzten Versuchs, odernull, wenn er nicht fehlgeschlagen ist oder keine erfasste Ursache hat, dann gibt es nurerrorMessage) und bei einem beendeten JobitemCauses(die Codes hinter seinen fehlgeschlagenen Elementen mit Anzahl, die häufigsten zuerst, höchstens drei). - Job-Details enthalten
failures(jedes fehlgeschlagene Element mit seinemfailure),failureCountundfailureGroups(die fehlgeschlagenen Elemente nach Ursache gruppiert, die häufigsten zuerst). - Gründe einer Prüfung enthalten
failure, den erklärten Grund. - Der letzte Backup-Job eines geschützten Objekts enthält ebenfalls
failure. - Der Webhook
job.failedenthält die Ursache indata.job.failure: dencode, ob sietransientist, dieparams(zum Beispiel die Berechtigung oder den Host), dietechnical-Details, den Zeitpunkt, den Schritt und den Wiederholungsstand. Ein Ticket kann die Ursache nennen, ohne Text auszuwerten.
Ein failure-Objekt der API hat diese Felder: code (der stabile Ursachencode), category (microsoft, imap, network, storage, crypto, verify, config, endpoint, share oder system), transient, retryable, params, technical, occurredAt, step, retry (Versuch, Limit und nächster Versuch, wenn der Job wieder eingereiht ist), steps (was zu tun ist, als Schritt-IDs mit der Zielseite) und docsUrl. Die Texte schreibt der Client, in der Sprache der lesenden Person. Code, der code liest, sollte Werte akzeptieren, die er nicht kennt: Ein neueres Restow kann Ursachen hinzufügen.
Die Ursachencodes
Abschnitt betitelt „Die Ursachencodes“Restow 0.4.7 ordnet Fehler 131 stabilen Ursachencodes zu. 30 davon gehören zu Backups von Freigaben (seit 0.4.0) und 22 zu Server- und Client-Backups, die übrigen 79 betreffen Microsoft 365 (einschließlich SharePoint-Websites), IMAP, das Netzwerk, Speicherziele, den Mail-Export, Verschlüsselung, Prüfung, Konfiguration und die Plattform selbst. Die Tabellen führen jeden Code mit seiner Überschrift auf.
- Vorübergehend heißt, Warten kann genügen: Restow versucht den Job von selbst erneut, solange er Versuche übrig hat.
- Jetzt erneut versuchen sagt, ob die Schaltfläche erscheint, sobald Sie die Ursache behoben haben.
Microsoft 365 (graph.*)
Abschnitt betitelt „Microsoft 365 (graph.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
graph.consent_missing |
Die Administratorzustimmung für Microsoft 365 fehlt oder wurde zurückgezogen | Nein | Ja |
graph.app_credentials_invalid |
Microsoft akzeptiert die Zugangsdaten der Restow-App nicht | Nein | Ja |
graph.tenant_not_found |
Microsoft kennt diesen Mandanten nicht | Nein | Ja |
graph.token_rejected |
Microsoft hat das Zugriffstoken nicht akzeptiert | Ja | Ja |
graph.permission_missing |
Der Restow-App fehlt eine Microsoft-365-Berechtigung | Nein | Ja |
graph.access_denied |
Microsoft hat den Zugriff auf dieses Postfach oder Laufwerk verweigert | Nein | Ja |
graph.mailbox_not_licensed |
Dieser Benutzer hat kein nutzbares Exchange-Online-Postfach | Nein | Ja |
graph.user_not_found |
Der Benutzer oder das Postfach existiert nicht mehr | Nein | Nein |
graph.mailbox_inactive |
Nicht gesichert: Das Konto ist deaktiviert oder hat keine Lizenz (seit 0.4.7; keine fehlgeschlagene Sicherung, siehe unten) | Nein | Nein |
graph.object_locked |
Nicht gesichert: Microsoft hat das OneDrive oder die Website gesperrt (seit 0.4.7; keine fehlgeschlagene Sicherung, siehe unten) | Nein | Nein |
graph.onedrive_unavailable |
Dieser Benutzer hat kein OneDrive, das Restow erreichen kann | Nein | Ja |
graph.throttled |
Microsoft bremst Restow aus (Drosselung) | Ja | Ja |
graph.service_unavailable |
Microsoft hatte ein vorübergehendes Dienstproblem | Ja | Ja |
graph.item_not_found |
Das Element wurde inzwischen bei Microsoft geändert oder gelöscht | Ja | Ja |
graph.item_too_large |
Das Element ist für Microsoft Graph zu groß | Nein | Nein |
graph.item_unreadable |
Das Element ist bei Microsoft beschädigt oder nicht lesbar | Nein | Nein |
graph.item_incomplete |
Microsoft hat das Element ohne Namen oder ohne seinen Ordner gemeldet | Ja | Ja |
graph.delta_expired |
Microsoft hat die Änderungsverfolgung eines Ordners ungültig gemacht | Ja | Ja |
graph.quota_exceeded |
Das Zielpostfach oder OneDrive ist voll | Nein | Ja |
graph.request_rejected |
Microsoft hat die Anfrage abgelehnt | Nein | Ja |
graph.site_unavailable |
Diese SharePoint-Website gibt es nicht mehr (seit 0.4.0; vorhandene Sicherungsstände bleiben wiederherstellbar, die nächste Verzeichnissynchronisierung kennzeichnet die Website als verwaist) | Nein | Ja |
graph.group_unavailable |
Diese Microsoft-365-Gruppe gibt es nicht mehr (seit 0.4.5; sie wurde gelöscht, oder ihr Team wurde entfernt; vorhandene Sicherungsstände bleiben wiederherstellbar, die nächste Verzeichnissynchronisierung kennzeichnet die Gruppe als verwaist) | Nein | Ja |
IMAP (imap.*)
Abschnitt betitelt „IMAP (imap.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
imap.auth_failed |
Der IMAP-Server hat die Anmeldung abgelehnt | Nein | Ja |
imap.oauth_failed |
Die OAuth2-Anmeldung des IMAP-Kontos funktioniert nicht mehr | Nein | Ja |
imap.credential_missing |
Für dieses IMAP-Konto ist kein Passwort hinterlegt | Nein | Ja |
imap.starttls_unavailable |
Der Server bietet die eingestellte verschlüsselte Verbindung nicht an | Nein | Ja |
imap.address_blocked |
Verbindungen zu diesem IMAP-Host sind nicht erlaubt | Nein | Ja |
imap.config_invalid |
Die IMAP-Quelle ist nicht richtig eingerichtet | Nein | Ja |
imap.command_failed |
Der IMAP-Server hat einen Befehl abgelehnt | Nein | Ja |
imap.mailbox_full |
Das IMAP-Postfach ist voll | Nein | Ja |
imap.server_limit |
Der IMAP-Server lehnt wegen eines Limits vorübergehend ab (seit 0.4.7) | Ja | Ja |
imap.connection_lost |
Die Verbindung zum IMAP-Server wurde unterbrochen | Ja | Ja |
imap.message_missing |
Der IMAP-Server hat eine aufgeführte Nachricht nicht ausgeliefert | Ja | Ja |
Der Code imap.oauth_failed gehört zu OAuth2 für IMAP-Quellen, das noch nicht umgesetzt ist; geplant (IMAP-Quellen verwenden heute ein Passwort). Er ist der Vollständigkeit halber aufgeführt.
imap.server_limit (seit 0.4.7) ist eine Ablehnung wegen eines Limits, das sich von selbst löst: eine Anmeldung, die der Server vorerst ablehnt (zu viele Verbindungen für das Konto, ein ausgefallenes Authentifizierungs-Backend, die Antwortcodes [UNAVAILABLE], [INUSE] oder [LIMIT]), oder ein Lesebefehl, der ein Download-Limit trifft ([LIMIT], [OVERQUOTA] oder ein Quota-Text). Es ist kein falsches Passwort und kein volles Postfach, und Restow versucht es später von selbst erneut. Der Verbindungstest einer IMAP-Quelle sagt „Der Server hat die Anmeldung vorübergehend abgelehnt“. Ein Limit, das der Server bei einem Lesebefehl meldet, lässt den Ordner als Ganzes fehlschlagen, und der nächste Lauf setzt fort, statt eines Fehlers je Nachricht; ein Limit, das ohne einen solchen Code oder Text gemeldet wird, kostet weiterhin einen Fehler je Nachricht. Ein Lauf, dessen Verbindung zu oft abbrach, scheitert als imap.connection_lost (vorübergehend) statt als „Ursache nicht erkannt“.
Netzwerk (network.*)
Abschnitt betitelt „Netzwerk (network.*)“Diese gelten für jeden entfernten Host, auch Microsoft und IMAP-Server. Die Erklärung nennt den Host und sagt, ob es der IMAP-Server der Quelle oder ein Microsoft-Dienst ist.
| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
network.dns |
Der Hostname lässt sich nicht auflösen | Ja | Ja |
network.unreachable |
Der Host ist nicht erreichbar | Ja | Ja |
network.timeout |
Der Host hat nicht rechtzeitig geantwortet | Ja | Ja |
network.tls |
Das TLS-Zertifikat des Hosts wird nicht akzeptiert | Nein | Ja |
Repositories und Speicher (storage.*)
Abschnitt betitelt „Repositories und Speicher (storage.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
storage.path_missing |
Der Speicherordner existiert nicht | Nein | Ja |
storage.not_writable |
Restow darf nicht in den Speicherordner schreiben | Nein | Ja |
storage.full |
Das Speicherziel ist voll | Nein | Ja |
storage.access_denied |
Der Speicherdienst hat den Zugriff verweigert | Nein | Ja |
storage.credentials_invalid |
Der Speicherdienst akzeptiert die Zugangsdaten nicht | Nein | Ja |
storage.bucket_missing |
Der Bucket existiert nicht | Nein | Ja |
storage.wrong_region |
Der Bucket liegt an einem anderen Endpunkt oder in einer anderen Region | Nein | Ja |
storage.unreachable |
Das Speicherziel ist nicht erreichbar | Ja | Ja |
storage.timeout |
Das Speicherziel hat nicht rechtzeitig geantwortet | Ja | Ja |
storage.tls |
Das TLS-Zertifikat des Speicher-Endpunkts wird nicht akzeptiert | Nein | Ja |
storage.rate_limited |
Der Speicherdienst begrenzt die Anfragen | Ja | Ja |
storage.integrity |
Daten im Speicher stimmen nicht mit dem überein, was Restow geschrieben hat | Nein | Ja |
storage.error |
Das Speicherziel hat einen unerwarteten Fehler gemeldet | Ja | Ja |
Mail-Export (export.*)
Abschnitt betitelt „Mail-Export (export.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
export.quota_exceeded |
Der Export ist größer als der Platz für Exporte | Nein | Ja |
Die nicht abgelaufenen Exporte eines Mandanten dürfen zusammen höchstens EXPORT_MAX_TENANT_BYTES belegen (Standard 50 GiB). Der Export stoppt und entfernt, was er geschrieben hat. Warten Sie, bis ältere Exporte ablaufen, exportieren Sie weniger Mail, oder erhöhen Sie die Grenze. Siehe Mail-Dateien importieren und exportieren.
Verschlüsselung (crypto.*)
Abschnitt betitelt „Verschlüsselung (crypto.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
crypto.key_missing |
Der Verschlüsselungsschlüssel fehlt | Nein | Ja |
crypto.key_invalid |
Daten lassen sich mit dem Schlüssel von Restow nicht entschlüsseln | Nein | Ja |
Prüfung und Wiederherstellbarkeit (verify.*)
Abschnitt betitelt „Prüfung und Wiederherstellbarkeit (verify.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
verify.hash_mismatch |
Wiederhergestellte Daten stimmen nicht mit dem Backup überein | Nein | Ja |
verify.chunk_missing |
Teile des Backups fehlen | Nein | Ja |
verify.pack_unreadable |
Backup-Daten im Speicher sind beschädigt | Nein | Ja |
verify.storage_corrupt |
Die Speicherprüfung hat beschädigte Daten gefunden | Nein | Ja |
verify.storage_unreadable |
Die Speicherprüfung konnte einige Daten nicht lesen (seit 0.4.2) | Ja | Ja |
verify.storage_unreadable_persistent |
Daten im Speicher sind seit mehr als einem Tag nicht lesbar (seit 0.4.2) | Nein | Ja |
verify.restore_test_failed |
Die Test-Wiederherstellung ist fehlgeschlagen | Nein | Ja |
verify.manifest_unreadable |
Das Verzeichnis des letzten Backups lässt sich nicht lesen | Nein | Ja |
verify.no_snapshot |
Es gibt noch kein Backup zum Wiederherstellen | Nein | Nein |
verify.snapshot_outdated |
Das letzte Backup ist zu alt | Nein | Nein |
verify.snapshot_stale |
Das letzte Backup wird alt | Nein | Nein |
verify.nothing_to_verify |
Das Backup enthält nichts, was sich prüfen ließe | Nein | Nein |
verify.restore_test_unconfirmed |
Das Ziel hat die Test-Wiederherstellung nicht bestätigt | Nein | Ja |
verify.incomplete |
Die Wiederherstellungsprüfung konnte nicht abgeschlossen werden (nichts bewertet, wird automatisch wiederholt) | Ja | Ja |
Zwei Ursachen gehören zur Speicherprüfung (seit 0.4.2) und sind keine Fehler eines Laufs, sondern die Gründe hinter einer Bewertung. verify.storage_unreadable sagt, dass einige Pack-Dateien bei der letzten Speicherprüfung auch nach erneutem Lesen nicht gelesen werden konnten: Die Verbindung brach ab, oder der Speicher verweigerte den Zugriff. Das beweist keinen Schaden, die Objekte, die sie nutzen, werden mit Achtung bewertet, und die nächste Prüfung liest diese Packs zuerst. verify.storage_unreadable_persistent sagt, dass dieselben Packs in 3 Prüfungen in Folge über mindestens 24 Stunden nicht gelesen werden konnten: Die Objekte, die sie nutzen, gelten als Nicht wiederherstellbar, bis eine Prüfung sie wieder liest, und die Schritte sind, die Erreichbarkeit und die Zugriffsrechte des Speichers zu prüfen und aus einer Kopie wiederherzustellen. Siehe Beschädigt oder vorübergehend nicht lesbar.
Restore-Prüfungen lesen eine Stichprobe zurück und vergleichen sie mit den festgehaltenen Hashes. Nur ein Beleg für einen Schaden bewertet eine Prüfung rot; eine Prüfung, die der Speicher nicht bedienen konnte, ist nicht abgeschlossen und nennt ihre Ursache, zum Beispiel storage.unreachable, storage.timeout oder storage.rate_limited, oder verify.incomplete, wenn keine Ursache bekannt ist (siehe Prüfung im Detail). Die optionale Test-Wiederherstellung in ein Ziel ist in 0.4.7 nicht angeschlossen; deshalb gehören verify.restore_test_failed und verify.restore_test_unconfirmed zu einer Funktion, die in diesem Release nicht aktiv ist.
Konfiguration (config.*)
Abschnitt betitelt „Konfiguration (config.*)“Dinge, die Sie in Ordnung bringen müssen, bevor ein Job laufen kann.
| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
config.source_not_connected |
Die Quelle ist noch nicht verbunden | Nein | Ja |
config.source_disabled |
Die Quelle ist ausgeschaltet | Nein | Ja |
config.object_excluded |
Dieses Objekt ist vom Schutz ausgenommen | Nein | Nein |
config.object_orphaned |
Dieses Objekt gibt es an der Quelle nicht mehr | Nein | Nein |
config.object_inactive |
Nicht gesichert, solange das Konto deaktiviert oder unlizenziert ist oder Microsoft das Objekt gesperrt hält (seit 0.4.7; keine fehlgeschlagene Sicherung, siehe unten) | Nein | Nein |
config.app_not_configured |
Die Microsoft-365-App dieser Installation ist nicht eingerichtet | Nein | Ja |
config.invalid |
Eine Einstellung verhindert, dass der Job läuft | Nein | Ja |
Server und Clients (endpoint.*)
Abschnitt betitelt „Server und Clients (endpoint.*)“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
endpoint.no_paths |
Keiner der eingestellten Ordner existiert auf dem Rechner | Nein | Ja |
endpoint.pre_hook_failed |
Der Befehl vor der Sicherung ist fehlgeschlagen | Nein | Ja |
endpoint.post_hook_failed |
Der Befehl nach der Sicherung ist fehlgeschlagen | Nein | Ja |
endpoint.hooks_not_allowed |
Ein Befehl vor oder nach der Sicherung wurde nicht ausgeführt | Nein | Ja |
endpoint.timeout |
Der Lauf hat zu lange gedauert | Ja | Ja |
endpoint.target_not_empty |
Der Wiederherstellungsordner ist nicht leer | Nein | Ja |
endpoint.invalid_task |
Der Rechner konnte die Anforderung nicht ausführen | Nein | Ja |
endpoint.hash_mismatch |
Eine wiederhergestellte Datei passt nicht zur gespeicherten Prüfsumme | Nein | Ja |
endpoint.file_missing |
Eine Stichprobendatei fehlt in der Sicherung | Nein | Ja |
endpoint.file_not_regular |
Eine Stichprobendatei ist keine reguläre Datei | Nein | Nein |
endpoint.read_error |
Einige Dateien konnten nicht gelesen werden | Nein | Ja |
endpoint.restic_failed |
Das Sicherungsprogramm wurde mit einem Fehler beendet | Nein | Ja |
endpoint.repository_locked |
Das Repository ist belegt | Ja | Ja |
endpoint.repository_missing |
Das Repository wurde nicht gefunden | Nein | Ja |
endpoint.repository_password |
Das Repository-Passwort wird abgelehnt | Nein | Nein |
endpoint.repository_refused |
Der Server hat die Anfrage abgelehnt | Nein | Nein |
endpoint.repository_damaged |
Das Repository ist beschädigt | Nein | Ja |
endpoint.network |
Der Rechner konnte den Server nicht erreichen | Ja | Ja |
endpoint.agent_stopped |
Der Agent ist während des Laufs stehen geblieben | Ja | Ja |
endpoint.interrupted |
Der Lauf wurde unterbrochen | Ja | Nein |
endpoint.silent |
Der Server meldet sich nicht | Nein | Nein |
endpoint.backup_overdue |
Seit Tagen keine gute Sicherung | Nein | Ja |
Freigaben (share.*, seit 0.4.0)
Abschnitt betitelt „Freigaben (share.*, seit 0.4.0)“Die Ursachen der Läufe von Freigaben: Sicherungen, Restores, Tests und Kopierjobs. Was bei jeder zu tun ist, steht unter Fehlerbehebung und Grenzen. share.locked_files, share.read_errors, share.files_dropped, share.acl_partial, share.offline_skipped und share.restore_partial sind Warnungen eines Laufs, der sonst beendet wurde: Der Lauf endet „mit Warnungen“.
| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
share.auth_failed |
Der Dateiserver hat das Konto abgelehnt | Nein | Ja |
share.unreachable |
Der Dateiserver antwortet nicht | Ja | Ja |
share.not_found |
Freigabe, Export oder Ordner gibt es nicht | Nein | Ja |
share.version_mismatch |
Der Server spricht die gewählte Protokollversion nicht | Nein | Ja |
share.permission_denied |
Das Konto darf diesen Ordner nicht lesen | Nein | Ja |
share.client_missing |
Dem Docker-Host fehlt der SMB- oder NFS-Client | Nein | Ja |
share.mount_failed |
Die Freigabe konnte nicht eingebunden werden | Nein | Ja |
share.address_blocked |
Die Adresse des Servers ist nicht erlaubt | Nein | Ja |
share.wrong_filesystem |
Die Freigabe war nicht wie erwartet eingebunden | Nein | Ja |
share.empty_source |
Die Freigabe ist leer | Nein | Ja |
share.include_missing |
Ein einbezogener Ordner existiert nicht mehr | Nein | Ja |
share.locked_files |
Einige Dateien waren auf dem Server geöffnet | Nein | Ja |
share.read_errors |
Einige Dateien konnten nicht gelesen werden | Nein | Ja |
share.files_dropped |
Viel weniger Dateien als beim letzten Mal | Nein | Nein |
share.acl_partial |
Berechtigungen wurden nicht für jede Datei gesichert oder wiederhergestellt | Nein | Nein |
share.offline_skipped |
Offline-Dateien wurden übersprungen | Nein | Nein |
share.restore_not_allowed |
Die Ziel-Freigabe erlaubt keine Wiederherstellung | Nein | Ja |
share.restore_partial |
Einige Dateien konnten nicht geschrieben werden | Nein | Ja |
share.copy_no_verified_point |
Noch kein geprüfter Sicherungsstand zum Kopieren | Nein | Ja |
share.copy_unsafe_target |
Das Kopierziel ist nicht sicher | Nein | Nein |
share.copy_empty_source |
Spiegelkopie abgelehnt: Die Quelle wirkt geleert | Nein | Ja |
share.repository_locked |
Das restic-Repository der Freigabe blieb gesperrt | Ja | Ja |
share.repository_damaged |
Das restic-Repository der Freigabe meldet einen Schaden | Nein | Ja |
share.quota_exceeded |
Das Speicherbudget für Freigabe-Sicherungen ist aufgebraucht | Nein | Ja |
share.out_of_memory |
Dem Runner ging der Speicher aus | Nein | Ja |
share.timeout |
Der Lauf dauerte zu lange | Nein | Ja |
share.mounter_unavailable |
Der Mounter läuft nicht | Ja | Ja |
share.runner_failed |
Der Runner endete ohne Ergebnis | Ja | Ja |
share.runner_lost |
Der Runner ist verschwunden | Ja | Ja |
share.runner_stalled |
Der Runner meldet sich nicht mehr | Ja | Ja |
Die Plattform selbst
Abschnitt betitelt „Die Plattform selbst“| Code | Bedeutung | Vorübergehend | Jetzt erneut versuchen |
|---|---|---|---|
database.unavailable |
Die Datenbank war nicht verfügbar | Ja | Ja |
database.error |
Die Datenbank hat einen Fehler gemeldet | Nein | Ja |
directory.conflict |
Die Schutzregeln haben sich während des Abgleichs geändert | Ja | Ja |
job.interrupted |
Der Job wurde unterbrochen | Ja | Ja |
unknown |
Die Ursache konnte nicht erkannt werden | Nein | Ja |