Logs
Il POS ha due interfacce di log: la schermata dei Log in-app (all'interno dell'applicazione POS) e la pagina dei Log in WP Admin (all'interno di WordPress). Insieme ti offrono un quadro completo dell'attività del POS per il debug e l'auditing.
Log dell'applicazione POS
Accesso ai Log
Apri la schermata dei Log dal menu di navigazione a sinistra (l'icona del battito cardiaco).
Panoramica dell'Interfaccia
Cerca & Filtra
- Cerca Log - Trova voci di log specifiche per contenuto del messaggio
- Filtro di Livello Log - Filtra per livello di log (info, warn, error)
- Impostazioni di visualizzazione - Configura le colonne visibili
Tabella dei Log
Ogni voce di log mostra:
| Colonna | Descrizione |
|---|---|
| Tempo | Quando si è verificato l'evento |
| Livello | Gravità: info (grigio), warn (arancione), error (rosso) |
| Messaggio | Descrizione comprensibile dell'evento |
| Contesto | JSON espandibile con dettagli aggiuntivi |
| Codice | Codice di errore (collegamenti alla documentazione) |
Livelli di Log
Info (Grigio)
Operazioni normali ed eventi riusciti:
- "Recuperati tutti gli ID per i prodotti"
- "Sincronizzati nuovi clienti"
- "Recuperati tutti gli ID per le tasse"
Avviso (Arancione)
Problemi non critici che potrebbero necessitare di attenzione:
- "Impossibile aggiornare la sessione"
- "Tentativo di ripetere la sincronizzazione"
Errore (Rosso)
Problemi che devono essere affrontati:
- "Spiacente, non puoi elencare le risorse" (problema di permesso)
- "Richiesta API non riuscita"
- "Errore di sincronizzazione del database"
Audit (Blu)
Il livello di log audit registra le modifiche al database effettuate dal POS, catturando lo stato completo prima-e-dopo di ogni modifica. Questo è utile per tracciare esattamente cosa è cambiato e quando, ad esempio durante la creazione di un ordine, gli aggiustamenti delle scorte o gli aggiornamenti dei clienti.
Le voci di audit includono:
- Tipo di entità - La risorsa che è stata modificata (ad es. ordine, prodotto, cliente)
- Azione - Il tipo di modifica (create, update, delete)
- Stato precedente - I valori precedenti prima della modifica
- Stato successivo - I nuovi valori dopo la modifica
Dati di Contesto
Fai clic sulla freccia di espansione su qualsiasi voce di log per vedere il contesto JSON dettagliato:
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
Questi dati includono:
- Conteggi degli elementi - Quanti record sono stati interessati
- Tempo di esecuzione - Quanto tempo ha impiegato l'operazione
- Carico del server - Metriche sulle prestazioni del server
- Dettagli richiesta/risposta - Per il debug dei problemi API
Codici di Errore
Molte voci di log includono un codice di errore (es. API02004, DB01001). Questi codici collegano direttamente alla documentazione Codici di Errore, che fornisce:
- Spiegazione dettagliata dell'errore
- Cause comuni
- Passaggi per la risoluzione dei problemi
Voci di Log Comuni
Operazioni di Sincronizzazione
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
Questi indicano un'attività di sincronizzazione normale. Il contesto mostra quanti elementi sono stati sincronizzati.
Errori di Permesso
[error] Sorry, you cannot list resources {...} API02004
Questo di solito significa che l'utente non ha il permesso di accedere a una risorsa. Controlla i ruoli utente in WP Admin > POS > Settings > Access.
Problemi di Sessione
[warn] Unable to refresh session {...} API02007
Il POS non è riuscito ad aggiornare la sessione di autenticazione. Questo potrebbe richiedere di disconnettersi e riconnettersi.
Pagina dei Log in WP Admin
Il plugin POS fornisce anche una pagina dei Log lato server nell'area di amministrazione di WordPress. Questa pagina mostra avvisi ed errori specifici del POS registrati sul server, il che può aiutare a diagnosticare problemi che potrebbero non apparire nell'applicazione POS stessa.
Accesso alla pagina dei Log in WP Admin
Naviga su WP Admin > POS > Settings, quindi seleziona la scheda Tools e clicca su Logs.
Badge Non Letti
La voce di menu Logs mostra un badge che indica le voci di log non lette:
- Badge rosso - Ci sono voci non lette di livello error
- Badge ambra - Ci sono voci non lette di livello warning (ma nessun errore)
Visitare la pagina dei Log azzera i conteggi non letti. I conteggi sono tracciati per utente, quindi ogni amministratore vede il proprio stato di non letto.
Filtraggio delle Voci
Usa il filtro di livello per restringere le voci di log:
- All - Mostra tutte le voci di log
- Errors - Mostra solo le voci di livello error
- Warnings - Mostra solo le voci di livello warning
Voci Espandibili
I messaggi di log lunghi vengono troncati a circa 100 caratteri. Clicca su una voce per espanderla e vedere il messaggio completo insieme a eventuali dati di contesto aggiuntivi.
Paginazione
Le voci di log sono paginate lato server. Usa i controlli di paginazione per navigare tra le voci più vecchie.
Banner degli Errori Fatali
Se il server ha file fatal-errors-*.log, la pagina dei Log mostra un banner di avviso in alto. Questo banner rimanda a WooCommerce > Status > Logs dove puoi visualizzare i log completi degli errori fatali. Gli errori fatali sono in genere arresti anomali a livello di PHP che impediscono all'API POS di rispondere.
Utilizzo dei Log per il Supporto
Quando richiedi supporto:
- Riproduci il problema - Ripeti l'azione che causa il problema
- Controlla i log - Cerca errori (rossi) o avvisi (arancioni)
- Espandi il contesto - Ottieni i dettagli JSON completi
- Annota il codice di errore - Includilo nella tua richiesta di supporto
- Copia voci rilevanti - Condividi i messaggi di log con contesto
Monitoraggio delle Prestazioni
I log includono il tempo di esecuzione e le metriche di carico del server. Se noti:
- Alti tempi di esecuzione - Il server potrebbe essere sovraccarico o lento
- Alti valori di carico del server - Considera l'ottimizzazione del server
- Timeout frequenti - Controlla la connettività di rete