Documentatie · Beheerdersreferentie
Beheerdersreferentie voor Logs
Dit document is een referentie voor het Logs-scherm van de ADP Car Market Hub plugin (Car Market Hub → Logs). Het legt uit hoe u recente fouten en waarschuwingen kunt controleren, het ruwe logbestand van de plugin kunt bekijken en dit indien nodig kunt wissen.
Wanneer u dit document moet gebruiken
Lees dit als u het volgende wilt doen:
- Controleren of de plugin recent fouten of waarschuwingen heeft geregistreerd.
- De nieuwste regels van het ruwe logbestand lezen.
- Het aantal weergegeven regels aanpassen.
- Het logbestand resetten (bijvoorbeeld om een schone trace te starten voordat u een probleem reproduceert voor support).
Overzicht
De plugin schrijft een enkel logbestand dat alleen aan het einde wordt aangevuld (append-only). Het Logs-scherm toont dit in drie blokken:
- Recente fouten — de meest recente logregels die het niveau
[ERROR]bevatten. - Recente waarschuwingen — de meest recente logregels die het niveau
[WARNING]bevatten. - Log Viewer — het ruwe einde (tail) van het logbestand met een configureerbaar aantal regels.
De panelen voor recente fouten en recente waarschuwingen tonen elk maximaal 50 van de meest recente regels, die om prestatieredenen uit de laatste 2.000 logregels worden gescand.
Vereisten of randvoorwaarden
- Een gebruiker met de beheerdersrechten van de plugin.
- Een beschrijfbaar logbestandspad op de server. Het huidige pad wordt boven de Log Viewer weergegeven.
Stapsgewijze instructies
Het logbestand inspecteren
- Open
Car Market Hub → Logs. - Gebruik Recente fouten en Recente waarschuwingen bovenaan om zaken te spotten die aandacht vereisen.
- Scrol naar de Log Viewer om het ruwe einde van het bestand te bekijken.
Het aantal weergegeven regels aanpassen
- Wijzig het veld Regels in de werkbalk boven de Log Viewer. Het toegestane bereik is 100 tot 2000 in stappen van 50.
- Klik op Herladen om het bestand opnieuw in te lezen met het nieuwe aantal regels.
Het logbestand wissen
- Klik op Logbestand wissen in de werkbalk van de Log Viewer.
- Bevestig de melding. Het logbestand wordt ingekort tot nul bytes.
- De plugin registreert dat het logbestand handmatig is gewist, zodat toekomstige regels kunnen worden gekoppeld aan een bekend resetpunt.
Het wissen van het logbestand is onomkeerbaar. Gebruik dit alleen wanneer u bewust een schone trace wilt starten.
Configuratiereferentie
Het Logs-scherm heeft geen permanente instellingen. De regelselector is uitsluitend een queryparameter per verzoek.
| Regelaar | Bereik / waarden | Opmerkingen |
|---|---|---|
| Regels | Geheel getal tussen 100 en 2000, stap 50 | Bepaalt hoeveel van de laatste regels de Log Viewer rendert. |
| Herladen | Knop | Leest het logbestand opnieuw in met het gekozen aantal regels. |
| Logbestand wissen | Destructieve knop | Kort het logbestand in tot nul bytes. Alleen zichtbaar als het bestand bestaat. |
Operationele opmerkingen
- Het pad naar het logbestand wordt boven de Log Viewer weergegeven. Behandel dit als een interne locatie en deel deze niet extern; raadpleeg deze alleen bij het debuggen op uw eigen server.
- Als het logbestand nog niet bestaat, toont het scherm een melding. Het bestand wordt automatisch aangemaakt bij de volgende logregel.
- De panelen voor recente fouten en recente waarschuwingen detecteren regels respectievelijk aan de hand van de substrings
[ERROR]en[WARNING]. Aangepaste log-writers die een ander formaat gebruiken, worden niet herkend. - Logrotatie, archivering en waarschuwingen over schijfgebruik worden weergegeven op het scherm Beheerdersreferentie voor Systeem & Hulp.
- De viewer rendert geescapete tekst binnen een
<pre>-blok. Klik op het gebied om alle inhoud te selecteren om te kopiëren.
Probleemoplossing
- "Could not clear log file (file not found or not writable)." Het logbestandspad is niet beschrijfbaar door de webserver-gebruiker, of het bestand bestaat niet. Controleer de bestandssysteemberechtigingen op het pad dat in de werkbalk wordt getoond.
- De regelselector reset na het wegnavigeren. Verwacht gedrag. Het aantal regels is een queryparameter per verzoek en wordt niet opgeslagen als instelling.
- Het logbestand lijkt leeg na een recente fout. Controleer of het juiste logbestand wordt bekeken (pad in de werkbalk) en of de falende bewerking daadwerkelijk via de logger van de plugin loopt. Sommige fatale PHP-fouten worden in plaats daarvan naar de WordPress
debug.loggeschreven — zie Beheerdersreferentie voor Systeem & Hulp. - "Recente fouten" is leeg, hoewel er iets is mislukt. Ofwel is de fout op een ander niveau gelogd (bijvoorbeeld
[INFO]), ofwel vond deze plaats buiten de laatste 2.000 regels die door de monitoringspanelen zijn gescand. Lees de ruwe Log Viewer.