Dokumentation · Admin-Referenz

Logs-Referenz

Dieses Dokument ist eine Referenz für den Logs-Bildschirm des ADP Car Market Hub-Plugins (Car Market Hub → Logs). Es erklärt, wie Sie aktuelle Fehler und Warnungen überwachen, die rohe Plugin-Logdatei einsehen und diese bei Bedarf leeren.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dies, wenn Sie Folgendes tun müssen:

Überprüfen, ob das Plugin kürzlich Fehler oder Warnungen protokolliert hat.
Die neuesten Einträge der rohen Logdatei lesen.
Anpassen, wie viele Zeilen angezeigt werden.
Die Logdatei zurücksetzen (zum Beispiel, um vor einer Support-Reproduktion eine saubere Aufzeichnung zu starten).

Übersicht

Das Plugin schreibt eine einzige Logdatei, an die neue Einträge nur angehängt werden. Der Logs-Bildschirm stellt diese in drei Blöcken dar:

Recent Errors (Aktuelle Fehler) — die neuesten Logeinträge, die das Level [ERROR] enthalten.
Recent Warnings (Aktuelle Warnungen) — die neuesten Logeinträge, die das Level [WARNING] enthalten.
Log Viewer (Log-Betrachter) — das rohe Ende der Logdatei mit einer konfigurierbaren Anzahl von Zeilen.

Die Panels für aktuelle Fehler und aktuelle Warnungen zeigen jeweils bis zu 50 der neuesten Einträge an, die aus Performancegründen aus den letzten 2'000 Logzeilen gescannt werden.

Anforderungen oder Voraussetzungen

Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
Ein beschreibbarer Logdateipfad auf dem Server. Der aktuelle Pfad wird über dem Log Viewer angezeigt.

Schritt-für-Schritt-Anleitung

Log einsehen

Öffnen Sie Car Market Hub → Logs.
Nutzen Sie Recent Errors und Recent Warnings im oberen Bereich, um Probleme zu erkennen, die Aufmerksamkeit erfordern.
Scrollen Sie zum Log Viewer, um das rohe Ende der Datei zu sehen.

Anzahl der angezeigten Zeilen anpassen

Ändern Sie in der Symbolleiste über dem Log Viewer das Feld Lines (Zeilen). Der zulässige Bereich liegt zwischen 100 und 2000 in Schritten von 50.
Klicken Sie auf Reload (Neu laden), um die Datei mit der neuen Zeilenanzahl neu einzulesen.

Logdatei leeren

Klicken Sie in der Symbolleiste des Log Viewers auf Clear log file (Logdatei leeren).
Bestätigen Sie den Dialog. Die Logdatei wird auf null Bytes gekürzt.
Das Plugin protokolliert, dass das Log manuell geleert wurde, damit zukünftige Einträge mit einem bekannten Rücksetzpunkt korreliert werden können.

Das Leeren des Logs ist unumkehrbar. Verwenden Sie dies nur, wenn Sie absichtlich eine saubere Aufzeichnung starten möchten.

Konfigurationsreferenz

Der Logs-Bildschirm hat keine dauerhaften Einstellungen. Die Zeilenauswahl (Lines) ist nur ein Query-Parameter pro Anfrage.

Steuerelement	Bereich / Werte	Hinweise
Lines	Ganzzahl zwischen 100 und 2000, Schrittweite 50	Steuert, wie viele der letzten Zeilen der Log Viewer darstellt.
Reload	Button	Liest die Logdatei mit der gewählten Zeilenanzahl neu ein.
Clear log file	Destruktiver Button	Kürzt die Logdatei auf null Bytes. Nur sichtbar, wenn die Datei existiert.

Betriebliche Hinweise

Der Logdateipfad wird über dem Log Viewer angezeigt. Behandeln Sie diesen als internen Pfad und vermeiden Sie es, ihn extern zu teilen; beziehen Sie sich nur darauf, wenn Sie auf Ihrem eigenen Server debuggen.
Wenn die Logdatei noch nicht existiert, zeigt der Bildschirm einen Hinweis an. Die Datei wird beim nächsten Logeintrag automatisch erstellt.
Die Panels für aktuelle Fehler und aktuelle Warnungen erkennen Einträge anhand der Teilstrings [ERROR] beziehungsweise [WARNING] . Benutzerdefinierte Log-Writer, die ein anderes Format verwenden, werden nicht abgeglichen.
Log-Rotation, Archivierung und Warnungen zur Festplattenbelegung werden auf dem Bildschirm System- und Hilfe-Referenz dargestellt.
Der Viewer stellt maskierten Text innerhalb eines <pre>-Blocks dar. Klicken Sie auf den Bereich, um den gesamten Inhalt zum Kopieren auszuwählen.

Fehlerbehebung

"Could not clear log file (file not found or not writable)." Der Logdateipfad ist für den Webserver-Benutzer nicht beschreibbar oder die Datei existiert nicht. Überprüfen Sie die Dateisystemberechtigungen für den in der Symbolleiste angezeigten Pfad.
Die Zeilenauswahl (Lines) setzt sich nach dem Verlassen der Seite zurück. Erwartetes Verhalten. Die Zeilenanzahl ist ein Query-Parameter pro Anfrage und wird nicht als Einstellung gespeichert.
Das Log erscheint nach einem kürzlichen Fehler leer. Stellen Sie sicher, dass die richtige Logdatei angezeigt wird (Pfad in der Symbolleiste) und dass die fehlgeschlagene Operation tatsächlich über den Logger des Plugins läuft. Einige schwerwiegende PHP-Fehler werden stattdessen in die WordPress debug.log geschrieben — siehe System- und Hilfe-Referenz.
"Recent Errors" ist leer, obwohl etwas fehlgeschlagen ist. Entweder wurde der Fehler auf einer anderen Stufe protokolliert (zum Beispiel [INFO]) oder er trat ausserhalb der letzten 2'000 Zeilen auf, die von den Überwachungspanels gescannt wurden. Lesen Sie den rohen Log Viewer.