Zum Hauptinhalt gehen

Hilfe holen: Support-Bericht, Fehlersuche und Diagnose

Aktualisiert

Wenn etwas nicht läuft, sammelst Du hier, was für die Suche nach der Ursache zählt: den Zustand des Servers, ausführliche Protokolle, die Ergebnisse der Diagnose und den Support-Bericht. Nichts davon wird automatisch gesendet.

Schritt 1: Den Zustand des Servers lesen

Öffne die Seite Einstellungen und klicke auf die Titelzeile der Kachel System und Support. Die Kachel gibt es in beiden Ansichten. Beim Aufklappen prüft das Plugin den Server neu.

Kachel System und Support mit zehn Zeilen und zwei Knöpfen

  1. Die Zeilen von oben nach unten: PHP-Version, Datenbankserver, WordPress-Version, Plugin-Version, PHP-Erweiterungen, Ordnerrechte, Gesperrte Funktionen, Speichergrenze, Zeitlimit und Freier Platz (Arbeitsordner).
  2. Ein gelber Punkt ist ein Hinweis, hier auf Funktionen, die der Hoster gesperrt hat.
  3. Bericht kopieren legt den Support-Bericht in die Zwischenablage.
  4. Bericht herunterladen speichert den Support-Bericht als Datei.
  5. Der Hinweis sagt, dass nichts automatisch gesendet wird.

Grün heißt in Ordnung, gelb ist ein Hinweis, rot ein Fehler. Serverpfade zeigt die Kachel nie.

Zeile Gelb oder rot, wenn
PHP-Version Rot: PHP ist älter als 7.4.
Datenbankserver Gelb: Der Server ist weder MySQL noch MariaDB.
PHP-Erweiterungen Rot: zlib oder mysqli fehlt; ohne sie arbeitet das Plugin nicht. Gelb: sodium, curl, mbstring oder openssl fehlt.
Ordnerrechte Rot: Das Plugin kann seinen Arbeitsordner oder seinen Protokoll-Ordner nicht anlegen oder beschreiben. Dahinter steht der Grund, zum Beispiel Das Upload-Verzeichnis ist nicht beschreibbar.
Gesperrte Funktionen Gelb: Der Hoster hat Funktionen gesperrt, die das Plugin berührt. Die Zeile nennt sie.
Speichergrenze Gelb: unter 64 MB.
Zeitlimit Gelb: set_time_limit ist gesperrt; die Schritte enden von selbst nach Zeit
Freier Platz (Arbeitsordner) Gelb: weniger als 256 MB frei. Grau: nicht messbar.

Schritt 2: Die Fehlersuche einschalten

Schalte auf die Ansicht Erweitert und klappe die Kachel Protokoll auf. Schalte Fehlersuche für 24 Stunden ein. Der Schalter speichert sofort.

Kachel Protokoll mit eingeschalteter Fehlersuche

  1. Fehlersuche für 24 Stunden schreibt ausführliche Zeilen ins Protokoll.
  2. Die Zeile darunter nennt, bis wann die Fehlersuche an ist. Danach schaltet sie sich selbst aus.

Wiederhole jetzt, was nicht geklappt hat, zum Beispiel das Backup. Erst dann stehen die ausführlichen Zeilen im Protokoll.

Schritt 3: Die Diagnose ausführen

In der Ansicht Erweitert zeigt die Kachel System und Support unten den Block Diagnose. Keine der vier Diagnosen erstellt ein Backup. Die Dateiliste fragt die Ziele nach ihrem freien Platz; die drei anderen berühren kein Ziel.

Block Diagnose mit vier Zeilen und je einem Knopf

  1. Probelauf misst, wie lange ein Schritt überlebt, welche Taktgeber ankommen, wie viele Megabyte je Sekunde der Arbeitsordner schreibt und wie viel Speicher frei ist.
  2. Ausführen startet die Diagnose der Zeile.
  3. Dateiliste ermittelt, was ein Backup enthalten würde und ob der Platz reicht.
  4. Datenbank-Export exportiert die Datenbank in den Arbeitsordner, liest das Ergebnis zurück und prüft es.
  5. Trockenlauf Dateien schreibt den Dateiteil eines Backups in den Arbeitsordner, ohne Ziel.

Jede Zeile zeigt ihren letzten Lauf mit Zeitpunkt und Kennzahlen, oder noch nie ausgeführt. Die Farbe des Punkts ist das Ergebnis: grün, gelb bei Warnungen, rot bei einem Fehler oder Abbruch. Klicke auf Ausführen. Die Diagnose läuft als Job: Die Seite zeigt den Fortschritt, und Backup abbrechen bricht sie ab. Am Ende meldet die Seite … beendet. oder … endete mit einem Fehler: …

Es läuft immer nur ein Job zur selben Zeit. Solange einer läuft, sind die Knöpfe gesperrt.

Schritt 4: Den Support-Bericht holen

Klicke auf Bericht kopieren oder Bericht herunterladen. Denselben Bericht kopiert Support-Bericht kopieren in der Hauptkachel der Seite.

  • Nach dem Kopieren meldet die Seite In die Zwischenablage kopiert. Lässt der Browser die Zwischenablage nicht zu, speichert er den Bericht als Datei.
  • Die Datei heißt cloneworx-backup-report_<Host>_<Datum>_<Uhrzeit>.txt und entsteht im Browser. Auf dem Server liegt sie nie.

Der Bericht ist reiner Text in englischer Sprache.

Der Bericht enthält Der Bericht enthält nicht
die Abschnitte Website, Server, Plugin, Einstellungen, Betrieb, Ziele, Pläne, die letzten zehn Jobs, Umfang, die letzten Läufe der Diagnose und die letzten 40 Zeilen des allgemeinen Protokolls Job-Namen und andere Kennungen von Backups, den Ordner-Code der Installation, die Namen von Zielen und Plänen (nur kurze Kennungen wie sftp-1 und plan-1), die Orte und Zugangsdaten der Ziele, E-Mail-Adressen (nur ihre Zahl) und Serverpfade (statt dessen <wp>, <wp-content>, <uploads>)

Prüfe den Bericht, bevor Du ihn weitergibst

Der Bericht nennt die Adresse Deiner Website. Er verlässt die Website nur durch Dich: über die Zwischenablage oder die Datei.

Schritt 5: Die Protokolle herunterladen

Klappe in der Ansicht Erweitert die Kachel Protokoll auf.

Kachel Protokoll mit Feld, Schalter und drei Knöpfen

  1. Protokolle aufbewahren für nimmt 7 bis 365 Tage, Vorgabe 30. Ältere Protokolle von Jobs löscht das Plugin.
  2. Fehlersuche für 24 Stunden ist hier aus.
  3. Protokoll schreibbar zeigt, ob das Plugin sein Protokoll schreiben kann. Bei Rot steht dahinter der Grund.
  4. Speichern speichert die Zahl der Tage.
  5. Alle Protokolle herunterladen speichert jedes Protokoll des Plugins in einer Datei.
  6. Protokoll anzeigen öffnet das allgemeine Protokoll mit seinen letzten 500 Zeilen.

Klicke auf Alle Protokolle herunterladen. Die Datei heißt cloneworx-backup-logs_<Host>_<Datum>_<Uhrzeit>.tar: ein unkomprimiertes tar-Archiv mit dem allgemeinen Protokoll, seiner Vorgängerdatei und je einem Protokoll für jeden Job. Gibt es noch keine, meldet die Seite Es gibt noch keine Protokolldateien.

Gut zu wissen

  • Das allgemeine Protokoll enthält, was zu keinem Job gehört: Verbindungstests der Ziele, Änderungen der Einstellungen, den Zeitplan.
  • Die Ergebnisse der Diagnose stehen auch im Support-Bericht. Führe die Diagnose deshalb vor dem Bericht aus.
  • Nach einem Fehler führt die rote Meldung der Seite mit einem Klick zum passenden Protokoll.

Siehe auch

Auf der Kommandozeile

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

Bericht, Fehlersuche, Protokolle und Diagnose gibt es auch mit WP-CLI. Eine Datei hinter --to darf es noch nicht geben.

# Den Support-Bericht ausgeben
wp cloneworx-backup support

# Den Support-Bericht in eine neue Datei schreiben
wp cloneworx-backup support --to=/pfad/cloneworx-bericht.txt

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

# Die Protokolldateien auflisten
wp cloneworx-backup logs

# Alle Protokolle in eine neue tar-Datei schreiben
wp cloneworx-backup logs --to=/pfad/cloneworx-protokolle.tar

# Den Probelauf ausführen
wp cloneworx-backup job probe

# Die Dateiliste ermitteln
wp cloneworx-backup job filelist

# Den Datenbank-Export prüfen
wp cloneworx-backup job dbexport

# Den Trockenlauf der Dateien ausführen
wp cloneworx-backup job files