# 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[​](#pos-application-logs "Collegamento diretto a Log dell'applicazione POS")

### Accesso ai Log[​](#accessing-logs "Collegamento diretto a Accesso ai Log")

Apri la schermata dei Log dal menu di navigazione a sinistra (l'icona del battito cardiaco).

### Panoramica dell'Interfaccia[​](#interface-overview "Collegamento diretto a Panoramica dell'Interfaccia")

#### Cerca & Filtra[​](#search--filter "Collegamento diretto a 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[​](#log-table "Collegamento diretto a 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[​](#log-levels "Collegamento diretto a Livelli di Log")

#### Info (Grigio)[​](#info-grey "Collegamento diretto a 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)[​](#warning-orange "Collegamento diretto a Avviso (Arancione)")

Problemi non critici che potrebbero necessitare di attenzione:

* "Impossibile aggiornare la sessione"
* "Tentativo di ripetere la sincronizzazione"

#### Errore (Rosso)[​](#error-red "Collegamento diretto a 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)[​](#audit-blue "Collegamento diretto a 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[​](#context-data "Collegamento diretto a 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[​](#error-codes "Collegamento diretto a Codici di Errore")

Molte voci di log includono un **codice di errore** (es. `API02004`, `DB01001`). Questi codici collegano direttamente alla documentazione [Codici di Errore](/it/error-codes/.md), che fornisce:

* Spiegazione dettagliata dell'errore
* Cause comuni
* Passaggi per la risoluzione dei problemi

### Voci di Log Comuni[​](#common-log-entries "Collegamento diretto a Voci di Log Comuni")

#### Operazioni di Sincronizzazione[​](#sync-operations "Collegamento diretto a 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[​](#permission-errors "Collegamento diretto a 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[​](#session-issues "Collegamento diretto a 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[​](#wp-admin-logs-page "Collegamento diretto a 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[​](#accessing-the-wp-admin-logs-page "Collegamento diretto a 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[​](#unread-badge "Collegamento diretto a 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[​](#filtering-entries "Collegamento diretto a 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[​](#expandable-entries "Collegamento diretto a 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[​](#pagination "Collegamento diretto a 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[​](#fatal-errors-banner "Collegamento diretto a 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[​](#using-logs-for-support "Collegamento diretto a Utilizzo dei Log per il Supporto")

Quando richiedi supporto:

1. **Riproduci il problema** - Ripeti l'azione che causa il problema
2. **Controlla i log** - Cerca errori (rossi) o avvisi (arancioni)
3. **Espandi il contesto** - Ottieni i dettagli JSON completi
4. **Annota il codice di errore** - Includilo nella tua richiesta di supporto
5. **Copia voci rilevanti** - Condividi i messaggi di log con contesto

## Monitoraggio delle Prestazioni[​](#performance-monitoring "Collegamento diretto a 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

## Documentazione Correlata[​](#related-documentation "Collegamento diretto a Documentazione Correlata")

[Codici di ErroreSpiegazioni dettagliate degli errori](/it/error-codes/.md)

[Risoluzione dei ProblemiProblemi comuni e soluzioni](/it/category/troubleshooting.md)

[SupportoOttenere aiuto](/it/support/.md)