Registri di controllo

Registri di controllo è un registro delle richieste effettuate al Performance Hub nella tua organizzazione. Comprende le richieste delle persone che usano il Performance Hub in un browser o nell'app e quelle degli strumenti connessi, come le chiavi API, gli agenti AI connessi tramite MCP e il Model Router. Usalo per rispondere a domande come chi ha sbloccato una porta, perché una modifica non è stata salvata o quando un'integrazione ha smesso di funzionare, che le tue sedi siano uffici, negozi, bar, locali, cliniche, campus o palestre.

Riferimento rapido

Dove trovarlo: Settings (icona a forma di ingranaggio, in basso a sinistra) → Registri di controllo

Chi può usarlo: ti serve un ruolo che includa Registri di controllo e Identity & Access Management nella tua organizzazione, come Organisation Administrator. Vedi Chi può usare Registri di controllo.

Scopo: vedere chi ha fatto cosa nel Performance Hub e scoprire perché una richiesta non è andata a buon fine

Figura 1: il pannello di controllo di Registri di controllo: l'intervallo di tempo, i dati principali e la timeline delle richieste

Cosa viene registrato

Ogni voce del registro corrisponde a una richiesta effettuata al Performance Hub. Mostra:

• Chi ha effettuato la richiesta: l'indirizzo email dell'utente.
• Da dove: l'indirizzo IP e il browser o lo strumento che l'ha inviata.
• Cosa è stato chiamato: il metodo (ad esempio GET per leggere o POST per creare) e l'endpoint, ovvero la parte del Performance Hub a cui era destinata la richiesta, come /api/door-gate-access/doors/front-entrance/unlock.
• Il risultato: lo stato della risposta, ad esempio 200 in caso di esito positivo o 403 quando la persona non aveva l'autorizzazione.
• Quanto tempo ha richiesto, in millisecondi.
• La provenienza: un badge di origine, come web per una persona che usa il Performance Hub o api-key per un'integrazione. Vedi Badge di origine.

Per le richieste recenti, la voce del registro contiene anche ciò che è stato inviato e ciò che è stato restituito. Vedi Leggere una voce del registro.

Le due schede

Chi può usare Registri di controllo

Ti serve un ruolo che includa Registri di controllo e Identity & Access Management nella tua organizzazione, come Organisation Administrator. Se non vedi Registri di controllo nel menu delle impostazioni, il tuo ruolo non lo include.

• Quali organizzazioni vedi: le organizzazioni in cui il tuo ruolo include sia Registri di controllo sia Identity & Access Management. La scheda Logs ne mostra il numero, ad esempio "Viewing logs for 1 organisation".
• Modelli di ruolo: il modello Organisation Administrator include Registri di controllo. I modelli Site Manager e Site Owner non lo includono. Vedi Modelli di ruolo.
• Ruoli personalizzati: per consentire a un ruolo personalizzato di usare Registri di controllo, includi sia Registri di controllo sia Identity & Access Management nel relativo accesso ai moduli. Vedi Ambito di accesso e accesso ai moduli.

Registri di controllo mostra gli indirizzi email delle persone, gli indirizzi IP e ciò che hanno inviato, quindi concedilo solo alle persone che ne hanno bisogno.

Per quanto tempo vengono conservati i registri

La conservazione dei registri di controllo stabilisce per quanto tempo vengono conservati: 90 giorni per ogni voce del registro e 7 giorni per i relativi payload completi di richiesta e risposta.

Il menu Range nella scheda Logs riporta:

"I registri di controllo vengono conservati per 90 giorni. I payload completi delle richieste e delle risposte vengono conservati per 7 giorni, dopodiché rimane una breve anteprima. È necessaria una cronologia più lunga? Contatta il supporto (potrebbero essere applicati costi aggiuntivi)."

Puoi quindi consultare gli ultimi 90 giorni. Per i primi 7 giorni una voce del registro contiene la richiesta e la risposta complete. Dopodiché, i contenuti più lunghi vengono ridotti a una breve anteprima. Vedi Dopo 7 giorni: anteprime.

Cosa puoi fare

• Leggere il pannello di controllo: visualizza il volume delle richieste, i tassi di errore e gli endpoint e gli utenti più attivi per un intervallo di tempo.
• Trovare le richieste: filtra per intervallo di tempo, indirizzo email, indirizzo IP, endpoint, organizzazione, struttura, metodo e stato e condividi una vista filtrata.
• Leggere una voce del registro: scopri chi ha effettuato una richiesta, da dove e cosa è stato inviato e restituito. Per una richiesta non riuscita, ottieni un riepilogo dell'errore in linguaggio semplice.
• Esportare i registri: scarica i registri caricati come file CSV.
• Seguire un esempio di indagine: risposte passo passo a domande comuni, come chi ha sbloccato una porta o perché un'integrazione ha smesso di sincronizzarsi.
• Domande frequenti

Pagine correlate

• Modelli di ruolo: quali modelli includono Registri di controllo
• Ambito di accesso e accesso ai moduli: assegna Registri di controllo a un ruolo personalizzato
• Door & Gate Access: Registri di accesso: il registro separato di ogni tentativo di sblocco di porte e cancelli