Riferimento Logs

Questo documento rappresenta un riferimento per la schermata Logs del plugin ADP Car Market Hub (Car Market Hub → Logs). Spiega come monitorare gli errori e gli avvisi recenti, visualizzare il file di log non elaborato del plugin e svuotarlo quando necessario.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

• Verificare se il plugin ha registrato errori o avvisi recenti.
• Leggere le voci più recenti del file di log non elaborato.
• Regolare il numero di righe visualizzate.
• Ripristinare il file di log (ad esempio per avviare una traccia pulita prima di una riproduzione per il supporto).

Panoramica

Il plugin scrive un singolo file di log di tipo append-only. La schermata Logs lo mostra in tre blocchi:

1. Recent Errors (Errori recenti) — le voci di log più recenti che contengono il livello [ERROR].
2. Recent Warnings (Avvisi recenti) — le voci di log più recenti che contengono il livello [WARNING].
3. Log Viewer (Visualizzatore log) — la parte finale non elaborata del file di log con un numero di righe configurabile.

I pannelli degli errori recenti e degli avvisi recenti mostrano ciascuno fino a 50 delle voci più recenti, scansionate dalle ultime 2.000 righe di log per motivi di prestazioni.

Requisiti o prerequisiti

• Un utente con i permessi di gestione del plugin.
• Un percorso del file di log scrivibile sul server. Il percorso corrente è mostrato sopra il Log Viewer.

Istruzioni passo dopo passo

Ispezionare il log

1. Apri Car Market Hub → Logs.
2. Utilizza Recent Errors e Recent Warnings in alto per individuare eventuali elementi che richiedono attenzione.
3. Scorri fino a Log Viewer per vedere la parte finale non elaborata del file.

Regolare il numero di righe visualizzate

1. Nella barra degli strumenti sopra il Log Viewer, modifica il campo Lines (Righe). L'intervallo consentito va da 100 a 2000 a passi di 50.
2. Fai clic su Reload (Ricarica) per rileggere il file con il nuovo conteggio delle righe.

Svuotare il file di log

1. Fai clic su Clear log file (Svuota file di log) nella barra degli strumenti del Log Viewer.
2. Conferma la finestra di dialogo. Il file di log viene troncato a zero byte.
3. Il plugin registra che il log è stato svuotato manualmente in modo che le voci future siano correlate a un punto di ripristino noto.

Lo svuotamento del log è irreversibile. Utilizza questa opzione solo quando desideri intenzionalmente avviare una traccia pulita.

Riferimento di configurazione

La schermata Logs non ha impostazioni persistenti. Il selettore Lines è solo un parametro di query per singola richiesta.

Note operative

• Il percorso del file di log è mostrato sopra il Log Viewer. Trattalo come una posizione interna ed evita di condividerlo esternamente; fai riferimento ad esso solo durante il debug sul tuo server.
• Se il file di log non esiste ancora, la schermata mostra un avviso. Il file viene creato automaticamente alla successiva voce di log.
• I pannelli degli errori recenti e degli avvisi recenti rilevano le voci rispettivamente tramite le sottostringhe [ERROR] e [WARNING] . I writer di log personalizzati che utilizzano un formato diverso non verranno associati.
• La rotazione dei log, l'archiviazione e gli avvisi sull'utilizzo del disco sono mostrati nella schermata Riferimento a sistema e supporto.
• Il visualizzatore mostra il testo con escape all'interno di un blocco <pre>. Fai clic sull'area per selezionare tutto il contenuto da copiare.

Risoluzione dei problemi

• "Could not clear log file (file not found or not writable)." Il percorso del file di log non è scrivibile dall'utente del server web, oppure il file non esiste. Verifica i permessi del file system sul percorso mostrato nella barra degli strumenti.
• Il selettore Lines si ripristina dopo aver navigato altrove. Comportamento previsto. Il conteggio delle righe è un parametro di query per singola richiesta e non viene memorizzato come impostazione.
• Il log appare vuoto dopo un errore recente. Conferma che si stia visualizzando il file di log corretto (percorso nella barra degli strumenti) e che l'operazione non riuscita passi effettivamente attraverso il logger del plugin. Alcuni errori fatali di PHP vengono scritti invece nel WordPress debug.log — vedi Riferimento a sistema e supporto.
• "Recent Errors" è vuoto anche se qualcosa non ha funzionato. L'errore è stato registrato a un livello diverso (ad esempio [INFO]), oppure si è verificato al di fuori delle ultime 2.000 righe scansionate dai pannelli di monitoraggio. Leggi il Log Viewer non elaborato.

Documenti correlati

• Riferimento a sistema e supporto
• Riferimento strumenti
• Riferimento supporto
• Riferimento impostazioni