Skip to main content
L’audit log ti offre una cronologia resistente alle manomissioni delle azioni che il tuo personale svolge sul tuo account: chi ha fatto cosa, su quale risorsa, da dove e se ha avuto successo. Usalo per indagare sulle modifiche, rispettare i requisiti di conformità e rispondere a domande come “chi ha annullato quell’ordine?” o “quando è stato aggiornato questo articolo del menu?”.
L’audit log è riservato a proprietari e amministratori dell’account. Il personale con altri ruoli vedrà un messaggio “restricted” quando prova ad aprirlo, e un amministratore il cui accesso è limitato a determinati store vede solo gli eventi di quegli store.

​
Dove trovarlo

1

Apri Logs

Nella barra laterale, clicca su Analytics per espandere la sezione, quindi seleziona Logs.
2

Apri l'audit log

Sotto l’intestazione Security, seleziona Audit Log.
3

Cerca e filtra

Gli eventi più recenti vengono caricati automaticamente. Restringi i risultati con i filtri, o esporta ciò che vedi in CSV.

​
Cosa viene registrato

Ogni voce cattura il contesto completo di una singola azione del personale: Selezionando una riga si espande un pannello di dettaglio con il metodo della richiesta, path, route, indirizzo IP, user agent, ID richiesta e trace ID, insieme al tipo di errore quando un’azione è fallita.

​
Quali azioni vengono registrate

  • Tutte le modifiche sono registrate — qualsiasi cosa crei, aggiorni o elimini dati (incluse azioni come archiviare, annullare, ripristinare o pubblicare).
  • Le letture sensibili sono registrate — visualizzare o scaricare report, esportazioni, fatture ed estratti conto. Aprire l’audit log stesso è registrato come read, ed esportarlo è registrato come export.
  • Le letture di routine (sfogliare elenchi, aprire viste di dettaglio, polling in background) non sono registrate, per mantenere il log focalizzato sull’attività significativa.
Le azioni intraprese dai clienti che effettuano ordini e dalle chiavi API sono fuori dall’ambito dell’audit log — si concentra sulle azioni del personale nella dashboard.

​
Chi ha modificato un’impostazione dello store, e quando

Il salvataggio di una pagina di impostazioni dello store viene registrato come qualsiasi altra modifica: un update sulla risorsa dietro quella pagina, attribuito al membro del personale che ha salvato e con timestamp del momento in cui l’ha fatto. Gli orari di apertura sono il caso più comune. Gli orari settimanali e i Special Opening Hours vengono salvati insieme con Save in Stores → il tuo store → Settings → Opening Hours, quindi entrambi arrivano come una singola voce con tipo di risorsa hour e azione Update.
1

Filtra sulle modifiche agli orari

Clicca su Add filter, scegli Resource type, inserisci hour e clicca su Apply. Aggiungi il filtro Action impostato su Update e il filtro Outcome impostato su Success — anche i salvataggi falliti vengono registrati e non hanno cambiato nulla.
2

Imposta l'intervallo di date

Il log si apre sugli ultimi 30 giorni. Per restringerlo, clicca sul pulsante dell’intervallo di date con l’icona del calendario a destra dei filtri e scegli un preset (Today, Yesterday, This month, Last month, This year, Last year, All time) oppure seleziona le date sul calendario. All time non farà emergere nulla oltre la tua finestra di conservazione.
3

Leggi la riga

Time è quando gli orari sono stati salvati, Actor è il membro del personale che li ha salvati (nome, email e ruolo al momento) e Store è lo store interessato — quindi puoi lasciare disattivato il filtro Store e leggere la colonna invece di cercare gli ID degli store.
4

Espandi per il dettaglio della richiesta

Selezionando la riga viene mostrato Path come /venues/<store id>/hours, l’IP address, lo User agent e il Request ID, e Fields changed come venueHours e specialHours.
Lo stesso approccio funziona per altre modifiche — filtra per tipo di risorsa (venue per le impostazioni proprie di uno store e menu, product o discount-code per le modifiche a catalogo e promozioni) e leggi le colonne Actor e Time.

​
Cosa non ti dice

  • I valori. Il log registra che gli orari sono stati modificati e quali campi erano coinvolti — mai gli orari prima e dopo. Non c’è modo di vedere gli orari di apertura precedenti nella dashboard.
  • Modifiche non effettuate da un membro del personale. Tutto ciò che viene fatto da una chiave API, da un’integrazione POS o di delivery, o da un cliente, è fuori ambito.
  • Qualsiasi cosa più vecchia della tua finestra di conservazione. 30 giorni di default (vedi Conservazione).
Se una modifica è più vecchia della tua finestra di conservazione, o è stata effettuata da un’integrazione, l’audit log non può dirti chi l’ha fatta. Contatta il supporto con lo store e la data approssimativa se hai comunque bisogno di indagarla.

​
Ricerca e filtri

L’audit log usa una barra di ricerca con faccette. Aggiungi uno o più filtri e clicca su Apply; i filtri attivi compaiono come pill rimovibili. Faccette disponibili: Di default il log mostra gli ultimi 30 giorni. I risultati sono paginati — usa Load more per recuperare eventi più vecchi. Puoi cancellare tutto con Clear all.
Combina le faccette per concentrarti su un incidente — ad esempio, filtra per Actor e Action: delete per vedere tutto ciò che uno specifico utente ha rimosso.

​
Esportare in CSV

Clicca su Export per scaricare i risultati attualmente filtrati come file CSV (con gli stessi filtri e intervallo di date applicati). È utile per condividere con revisori o archiviare al di fuori di storekit.
Le esportazioni sono limitate a 50.000 righe. Se raggiungi il limite, restringi l’intervallo di date o aggiungi filtri ed esporta in batch più piccoli.

​
Privacy e gestione dei dati

L’audit log è progettato per registrare cosa è cambiato senza catturare contenuti sensibili:
  • Memorizza i nomi dei campi coinvolti in una modifica (es. “price, availability”) — mai i valori effettivi che sono stati inviati.
  • I nomi dei campi che sembrano sensibili (password, token, chiavi, dettagli della carta, PIN e simili) vengono automaticamente eliminati e non vengono mai registrati.
  • I record sono append-only: le voci non vengono mai modificate o eliminate singolarmente, quindi la cronologia rimane affidabile.

​
Conservazione

Le voci dell’audit vengono conservate per 30 giorni di default, e il log si apre sulla stessa finestra di 30 giorni. La conservazione è impostata per account, quindi gli account che necessitano di una cronologia più lunga per la conformità possono richiederla.
Solo proprietari e amministratori dell’account. Gli altri ruoli del personale non possono visualizzarlo o esportarlo.
Il log registra intenzionalmente solo modifiche e letture sensibili (report, esportazioni, fatture, estratti conto). La navigazione quotidiana e le richieste in background sono escluse in modo che il log rimanga focalizzato sull’attività significativa.
No. Registra quali campi sono stati coinvolti in una modifica, ma non i valori inviati. I nomi dei campi sensibili vengono eliminati completamente.
Le voci vengono conservate per 30 giorni di default. Se hai bisogno di una conservazione più lunga per la conformità, contatta il nostro team.
Puoi esportare i risultati filtrati, fino a 50.000 righe per esportazione. Per intervalli più grandi, suddividi l’esportazione in finestre di date più piccole.