Dokumentation · Admin-Referenz

Logs-Referenz

Dieses Dokument ist eine Referenz für den Logs-Bildschirm des ADP Car Market Hub-Plugins (CMH Center → Logs). Es erklärt, wie Sie die neuesten Fehler und Warnungen überwachen, die rohe Logdatei des Plugins 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 in letzter Zeit Fehler oder Warnungen protokolliert hat.
Die neuesten Einträge der rohen Logdatei lesen.
Die Anzahl der angezeigten Zeilen anpassen.
Die Logdatei zurücksetzen (zum Beispiel, um vor einer Support-Reproduktion eine saubere Aufzeichnung zu starten).

Übersicht

Das Plugin schreibt eine einzige, fortlaufend ergänzte Logdatei. Der Logs-Bildschirm stellt diese in drei Blöcken dar:

Recent Errors (Letzte Fehler) — die neuesten Logeinträge, die das Level [ERROR] enthalten.
Recent Warnings (Letzte 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 die letzten Fehler und die letzten Warnungen zeigen jeweils bis zu 50 der neuesten Einträge an, die aus Performancegründen aus den letzten 2'000 Logzeilen ausgelesen 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 inspizieren

Öffnen Sie CMH Center → 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 lediglich ein Abfrageparameter 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	Schaltfläche	Liest die Logdatei mit der gewählten Zeilenanzahl neu ein.
Clear log file	Destruktive Schaltfläche	Kürzte die Logdatei auf null Bytes. Nur sichtbar, wenn die Datei existiert.

Betriebliche Hinweise

Der Pfad zur Logdatei wird über dem Log Viewer angezeigt. Behandeln Sie diesen als internen Speicherort und vermeiden Sie es, ihn extern zu teilen; beziehen Sie sich nur darauf, wenn Sie auf Ihrem eigenen Server Fehler beheben.
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 die letzten Fehler und die letzten 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 Pfad der Logdatei 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 Abfrageparameter pro Anfrage und wird nicht als Einstellung gespeichert.
Das Log erscheint nach einem kürzlichen Fehler leer. Vergewissern Sie sich, dass die richtige Logdatei betrachtet 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 das 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.