Logs
La schermata dei Log registra l'attività del sistema all'interno del POS. È uno strumento essenziale per il debug dei problemi e per comprendere cosa sta accadendo dietro le quinte.
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"
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 > Impostazioni > Accesso.
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.
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