Zum Hauptinhalt gehen

Das Protokoll lesen

Aktualisiert

Das Protokoll hält Zeile für Zeile fest, was bei einem Backup, einer Prüfung oder einem Restore geschehen ist. So öffnest und liest Du es.

Es gibt zwei Arten. Jeder Job hat sein eigenes Job-Protokoll. Das allgemeine Protokoll enthält, was zu keinem Job gehört: die Verbindungstests der Ziele, Änderungen an den Einstellungen, den Zeitplan.

Schritt 1: Das Protokoll öffnen

Wo Was sich öffnet
Rote Meldung nach einem Job, gelbe Meldung nach einem Backup, einer Prüfung oder einer Diagnose: Protokoll das Protokoll dieses Jobs
Rote Meldung ohne Job und gelbe Meldung nach einem gescheiterten Verbindungstest: Protokoll anzeigen das allgemeine Protokoll
Liste der Backups auf den Seiten Übersicht, Backup und Restore: Mehr …, dann Protokoll das Protokoll dieses Backups
Statuskachel der Übersicht nach einem Backup mit Warnungen oder Fehler und bei einem überfälligen Plan: Protokoll das Protokoll des Backups, das die Kachel nennt
Seite Restore, Ansicht Erweitert, Kachel Letzte Restores: Protokoll das Protokoll dieses Restores
Seite Einstellungen, Ansicht Erweitert, Kachel Protokoll: Protokoll anzeigen das allgemeine Protokoll

Die gelbe Meldung nach einem Restore trägt keinen Link. Das Protokoll eines Restores öffnest Du in der Kachel Letzte Restores.

Gelbe Meldung nach einem Backup mit Warnungen

  1. Die Meldung nennt Zahl und Art der Warnungen.
  2. Protokoll öffnet das Protokoll dieses Backups. Dort stehen die Namen der Einträge.
  3. Das Kreuz schließt die Meldung. Gelbe und rote Meldungen bleiben stehen, bis Du sie schließt oder eine neue Aktion beginnst.

Schritt 2: Die Zeilen lesen

Das Fenster heißt immer Protokoll. Die Zeilen stehen in der Reihenfolge, in der sie geschrieben wurden: die älteste oben, die jüngste ganz unten.

Fenster Protokoll mit dem Protokoll eines Backups

  1. Vorn steht die Uhrzeit, in der Zeitzone der Website.
  2. Es folgt die Stufe, dahinter die Meldung.
  3. Die Einzelheiten zur Meldung stehen klein darunter.
  4. Bei dieser Warnung nennen die Einzelheiten den Eintrag, der nicht gesichert werden konnte, und den Grund.
Stufe Bedeutung
INFO Ein gewöhnlicher Schritt des Ablaufs.
WARNING, gelb Eine Warnung: Etwas lief nicht glatt.
ERROR, rot Ein Fehler: Etwas ist gescheitert.
DEBUG, grau Ausführliche Zeilen, nur bei eingeschalteter Fehlersuche.

Ein langes Protokoll

Das Fenster zeigt höchstens die letzten 500 Zeilen eines Protokolls. Hat das Protokoll mehr Zeilen, steht über der Liste Nur die letzten … Zeilen werden gezeigt.

Fenster Protokoll mit dem Hinweis auf die letzten Zeilen und mit Zeilen der Fehlersuche

  1. Der Hinweis sagt, dass das Fenster nur die letzten 500 Zeilen des Protokolls zeigt.
  2. Eine Zeile der Stufe DEBUG steht in Grau. Solche Zeilen schreibt das Plugin nur bei eingeschalteter Fehlersuche.

Nach dem Öffnen steht die Liste an ihrem Anfang: Du siehst die ältesten der gezeigten Zeilen. Die jüngste Zeile findest Du ganz unten: Rolle in der Liste bis ans Ende. Von selbst springt das Fenster nicht dorthin. Ältere Zeilen als die gezeigten stehen im Download aller Protokolle.

Die Meldungen im Protokoll sind englisch. Passwörter und Schlüssel stehen dort nie im Klartext; an ihrer Stelle steht ********.

Schritt 3: Die Warnungen finden

Endet ein Backup mit Warnungen, nennt die Meldung nur Zahl und Art. Das Protokoll nennt jeden Eintrag beim Namen, in einer Zeile der Stufe WARNING:

  • Entry could not be backed up. Der Eintrag wurde nicht gesichert.
  • File changed while it was being read; the backup holds what was read. Die Datei hat sich beim Lesen geändert. Das Backup enthält, was gelesen wurde.

In den Einzelheiten steht hinter entry der Pfad innerhalb der Website, nie ein Pfad des Servers, und hinter reason der Grund:

Grund Bedeutung
unreadable nicht lesbar
vanished verschwunden, bevor das Plugin den Eintrag lesen konnte
unsupported nicht unterstützt: weder Datei noch Ordner noch Link
missing aus einem anderen Grund nicht gesichert; die Meldung zählt diese Einträge zu den verschwundenen
changed beim Lesen geändert

Das Protokoll nennt höchstens 50 Einträge je Grund. Weitere zählt es, ohne sie zu nennen: More entries of this kind follow; they are counted, not listed.

Das allgemeine Protokoll

Fenster Protokoll mit dem allgemeinen Protokoll

  1. Vorn stehen Datum und Uhrzeit, in der Zeitzone der Website. Das Datum steht dabei, weil dieses Protokoll über Tage reicht.
  2. Es folgt die Stufe, dahinter die Meldung.
  3. Darunter stehen die Einzelheiten zur Meldung.
  4. Diese Zeile meldet einen Fehler.

Protokolle aufbewahren und herunterladen

Öffne die Seite Einstellungen, schalte auf Erweitert und klicke auf die Titelzeile der Kachel Protokoll.

Kachel Protokoll auf der Seite Einstellungen

  1. Protokolle aufbewahren für nimmt 7 bis 365 Tage, Vorgabe ist 30. Ältere Job-Protokolle löscht das Plugin einmal am Tag.
  2. Fehlersuche für 24 Stunden schaltet ausführliche Zeilen ein.
  3. Protokoll schreibbar zeigt, ob das Plugin sein Protokoll schreiben kann. Wenn nicht, steht der Grund dahinter.
  4. Speichern speichert die Zahl der Tage.
  5. Alle Protokolle herunterladen speichert alle Protokolle als eine Datei.
  6. Protokoll anzeigen öffnet das allgemeine Protokoll.

Die Datei heißt cloneworx-backup-logs_<Host>_<Datum>_<Uhrzeit>.tar und ist nicht komprimiert. Im Ordner cloneworx-backup-logs liegen das allgemeine Protokoll mit seiner Vorgängerdatei und je Job eine Datei. Jede Zeile einer Datei nennt Zeitstempel, Stufe, Quelle, Meldung und Einzelheiten, getrennt durch senkrechte Striche. Das Plugin sendet Protokolle nie von selbst irgendwohin.

Die Fehlersuche einschalten

Der Schalter wirkt sofort. Nach 24 Stunden schaltet sich die Fehlersuche selbst aus.

Kachel Protokoll mit eingeschalteter Fehlersuche

  1. Fehlersuche für 24 Stunden ist eingeschaltet.
  2. Die Zeile darunter nennt den Zeitpunkt: Die Fehlersuche ist bis … an.

Schalte die Fehlersuche ein, bevor Du einen gescheiterten Vorgang wiederholst. Die ausführlichen Zeilen stehen dann im Protokoll des neuen Vorgangs, zwischen den anderen Zeilen. Eine eigene Datei bekommen sie nicht.

Wenn etwas nicht klappt

Meldung Bedeutung
Zu diesem Backup gibt es kein Protokoll mehr. Protokolle werden … Tage aufbewahrt. Die Datei ist gelöscht, weil die Zeit der Aufbewahrung um ist, oder nach einem Umzug der Website nicht mehr da.
Es gibt noch kein allgemeines Protokoll. Es wurde noch nichts geschrieben, das zu keinem Job gehört.
Das Protokoll konnte nicht geladen werden. Der Grund steht dahinter. Lade die Seite neu und öffne das Protokoll noch einmal.

Gut zu wissen

  • Ein Job-Protokoll nimmt ab 5 MB nur Warnungen und Fehler an, ab 10 MB nichts mehr. Das allgemeine Protokoll beginnt bei 5 MB eine neue Datei; die bisherige bleibt als Vorgängerdatei.
  • Protokolle liegen auf dem Webserver, nie an einem Ziel.

Siehe auch

Auf der Kommandozeile

WP-CLI noch nicht eingerichtet? So installierst Du WP-CLI.

WP-CLI listet die Protokolldateien, schreibt alle in eine tar-Datei und schaltet die Fehlersuche. Die Datei hinter --to darf es noch nicht geben. Den Inhalt eines Protokolls zeigt logs nicht; dafür öffnest Du die Dateien aus dem Archiv.

# Die Protokolldateien mit Größe und Datum zeigen
wp cloneworx-backup logs

# Alle Protokolle als eine tar-Datei schreiben
wp cloneworx-backup logs --to=/tmp/cloneworx-logs.tar

# Die Fehlersuche für 24 Stunden einschalten
wp cloneworx-backup debug on

# Zeigen, ob die Fehlersuche an ist, und bis wann
wp cloneworx-backup debug status

# Die Fehlersuche ausschalten
wp cloneworx-backup debug off