Dokumentation · Admin-Referenz

Protokoll-Referenz

Dieses Dokument ist eine Referenz für die Ansicht Protokolle des ADP Car Market Hub-Plugins (Car Market Hub → Logs). Es erklärt, wie Sie aktuelle Fehler und Warnungen überwachen, die Rohdatei des Plugin-Protokolls 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 Roh-Protokolldatei lesen.
Anpassen, wie viele Zeilen angezeigt werden.
Die Protokolldatei zurücksetzen (beispielsweise um vor einer Support-Reproduktion eine saubere Aufzeichnung zu starten).

Übersicht

Das Plugin schreibt eine einzelne Protokolldatei, an die neue Einträge nur angehängt werden. Die Protokoll-Ansicht stellt diese in drei Blöcken dar:

Aktuelle Fehler – die neuesten Protokolleinträge, die die Stufe [ERROR] enthalten.
Aktuelle Warnungen – die neuesten Protokolleinträge, die die Stufe [WARNING] enthalten.
Protokoll-Viewer – das rohe Ende (Tail) der Protokolldatei mit einer konfigurierbaren Anzahl von Zeilen.

Die Bereiche für aktuelle Fehler und aktuelle Warnungen zeigen jeweils bis zu 50 der neuesten Einträge an, die aus Performance-Gründen aus den letzten 2.000 Protokollzeilen ausgelesen werden.

Voraussetzungen oder Vorbedingungen

Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
Ein beschreibbarer Pfad für die Protokolldatei auf dem Server. Der aktuelle Pfad wird über dem Protokoll-Viewer angezeigt.

Schritt-für-Schritt-Anleitung

Protokoll prüfen

Öffnen Sie Car Market Hub → Logs.
Nutzen Sie die Bereiche Aktuelle Fehler und Aktuelle Warnungen im oberen Bereich, um auffällige Einträge zu finden.
Scrollen Sie zum Protokoll-Viewer, um das rohe Ende der Datei zu sehen.

Anzahl der angezeigten Zeilen anpassen

Ändern Sie in der Symbolleiste über dem Protokoll-Viewer das Feld Zeilen. Der zulässige Bereich liegt zwischen 100 und 2000 in 50er-Schritten.
Klicken Sie auf Neu laden, um die Datei mit der neuen Zeilenanzahl erneut einzulesen.

Protokolldatei leeren

Klicken Sie in der Symbolleiste des Protokoll-Viewers auf Protokolldatei leeren.
Bestätigen Sie den Dialog. Die Protokolldatei wird auf null Byte gekürzt.
Das Plugin registriert, dass das Protokoll manuell geleert wurde, damit zukünftige Einträge mit einem bekannten Rücksetzpunkt korreliert werden können.

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

Konfigurationsreferenz

Die Protokoll-Ansicht verfügt über keine dauerhaften Einstellungen. Die Zeilenauswahl ist lediglich ein Abfrageparameter pro Anfrage (Query-Parameter).

Steuerelement	Bereich / Werte	Hinweise
Zeilen	Ganzzahl zwischen 100 und 2000, Schrittweite 50	Steuert, wie viele Endzeilen der Protokoll-Viewer darstellt.
Neu laden	Schaltfläche	Liest die Protokolldatei mit der gewählten Zeilenanzahl neu ein.
Protokolldatei leeren	Destruktive Schaltfläche	Kürzt die Protokolldatei auf null Byte. Nur sichtbar, wenn die Datei existiert.

Betriebshinweise

Der Pfad zur Protokolldatei wird über dem Protokoll-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 Protokolldatei noch nicht existiert, zeigt die Ansicht einen Hinweis an. Die Datei wird beim nächsten Protokolleintrag automatisch erstellt.
Die Bereiche für aktuelle Fehler und aktuelle Warnungen erkennen Einträge anhand der Teilstrings [ERROR] bzw. [WARNING] . Benutzerdefinierte Protokoll-Writer, die ein anderes Format verwenden, werden nicht abgeglichen.
Protokollrotation, Archivierung und Warnungen zur Festplattenbelegung werden in der System- und Hilfe-Referenz angezeigt.
Der Viewer stellt maskierten Text innerhalb eines <pre>-Blocks dar. Klicken Sie auf den Bereich, um den gesamten Inhalt zum Kopieren auszuwählen.

Fehlerbehebung

"Protokolldatei konnte nicht geleert werden (Datei nicht gefunden oder nicht beschreibbar)." Der Pfad der Protokolldatei 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 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 Protokoll erscheint nach einem kürzlichen Fehler leer. Stellen Sie sicher, dass die richtige Protokolldatei angezeigt wird (Pfad in der Symbolleiste) und dass der fehlgeschlagene Vorgang 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.
"Aktuelle Fehler" ist leer, obwohl etwas fehlgeschlagen ist. Entweder wurde der Fehler auf einer anderen Stufe protokolliert (z. B. [INFO]) oder er trat außerhalb der letzten 2.000 Zeilen auf, die von den Überwachungsbereichen gescannt wurden. Lesen Sie den rohen Protokoll-Viewer.