Leggere una voce del registro
In questa pagina
Fai clic su una richiesta nell'elenco della scheda Logs per aprirne i dettagli a destra. I dettagli mostrano quando è stata effettuata la richiesta, chi l'ha effettuata e da dove, cosa è stato inviato e cosa è stato restituito. Per una richiesta non riuscita, puoi anche chiedere un riepilogo dell'errore in linguaggio semplice.
Riferimento rapido
Dove trovarlo: Settings (icona a forma di ingranaggio, in basso a sinistra) → Registri di controllo → Logs, quindi fai clic su una richiesta
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 esattamente cosa è successo in una richiesta
Aprire una voce del registro
- Nella scheda Logs, filtra l'elenco in base alle richieste che ti servono.
- Fai clic su una richiesta. I suoi dettagli si aprono a destra e la richiesta viene evidenziata nell'elenco.
- Usa i tasti freccia su e giù per scorrere l'elenco senza uscire dai dettagli.
La parte superiore dei dettagli riporta di nuovo lo stato, il metodo, il badge di origine e l'endpoint.
Figura 1: una voce del registro: quando è avvenuta, chi l'ha effettuata, da dove e i corpi della richiesta e della risposta
I campi
Nel Performance Hub i campi sono mostrati in maiuscolo, in questo ordine:
| Campo | Cosa mostra |
|---|---|
| Timestamp | La data e l'ora della richiesta |
| Response Time | Il tempo impiegato dal Performance Hub per rispondere, in millisecondi |
| Request ID | Un ID univoco per questa richiesta. Fai clic sul pulsante di copia per copiarlo, ad esempio per comunicarlo all'assistenza. |
| IP Address | L'indirizzo IP da cui proviene la richiesta |
| User | L'indirizzo email della persona che ha effettuato la richiesta |
| Referer | La pagina da cui è stata effettuata la richiesta, se presente |
| User Agent | Il browser, l'app o lo strumento che ha inviato la richiesta |
| Struttura | La struttura a cui era destinata la richiesta, nel formato "Nome (id)", ad esempio Lower Manhattan e il suo ID struttura |
| Organizzazione | L'organizzazione, nel formato "Nome (id)" |
Richiesta e risposta
Sotto i campi si trovano i corpi della richiesta, se presenti:
| Sezione | Cosa mostra |
|---|---|
| Request POST Body | Ciò che è stato inviato, ad esempio il motivo indicato per lo sblocco di una porta o i nuovi orari di una struttura. L'intestazione riporta "Request POST Body" per ogni metodo che invia un corpo. |
| Response Body | Ciò che il Performance Hub ha restituito, compresi eventuali messaggi di errore |
| Query Parameters | Le opzioni aggiunte alla richiesta, come un numero di pagina o una struttura |
Fai clic su Copy section (l'icona di copia in alto a destra di una sezione) per copiarne il contenuto, ad esempio per incollarlo in una richiesta di assistenza.
Se una richiesta non ha nulla da mostrare, i dettagli riportano "No request/response payloads recorded for this entry." Molte richieste GET, che si limitano a leggere informazioni, non hanno un corpo della richiesta.
Riepilogo degli errori AI
Per una richiesta non riuscita, con uno stato pari o superiore a 400, i dettagli includono una sezione AI Error Summary.
- Fai clic su Generate summary.
- Leggi il riepilogo. Spiega in linguaggio semplice cosa è andato storto e cosa fare dopo.
Figura 2: per una richiesta non riuscita, Generate summary spiega l'errore in linguaggio semplice
- Il riepilogo viene generato solo quando fai clic su Generate summary. Una volta generato, il riepilogo può mostrare l'etichetta cached.
- È generato dall'AI e può essere errato. Confrontalo con il Response Body, che contiene il messaggio effettivamente restituito dal Performance Hub.
- Se il riepilogo non può essere generato, un avviso ti chiede di riprovare più tardi. Nel frattempo leggi il Response Body.
Dopo 7 giorni: anteprime
I corpi completi della richiesta e della risposta vengono conservati per 7 giorni. Dopodiché, i corpi più lunghi vengono ridotti a una breve anteprima e i dettagli riportano "Full request and response payloads are kept for 7 days. Showing a preview for this log." I corpi brevi che rientrano nell'anteprima restano completi.
Il resto della voce del registro, ad esempio chi ha effettuato la richiesta, quando e con quale risultato, viene conservato per 90 giorni.
Figura 3: dopo 7 giorni resta solo una breve anteprima della richiesta e della risposta
Se potrebbero servirti i corpi completi in seguito, apri la richiesta e usa Copy section entro 7 giorni. Un'esportazione CSV non include i corpi.
Codici di stato
Lo stato è il primo elemento di ogni riga. La sua prima cifra indica il tipo di risultato:
| Stato | Significato | Esempi |
|---|---|---|
| 2xx | Esito positivo | 200 OK, 201 Created |
| 3xx | Reindirizzamento: la richiesta è stata inviata altrove | 301 Moved |
| 4xx | Un problema con la richiesta, ad esempio un'autorizzazione mancante o un input non valido | 400 Bad Request (un valore non era valido), 401 Unauthorised (accesso non effettuato), 403 Forbidden (nessuna autorizzazione), 404 Not Found, 409 Conflict (la richiesta era in conflitto con lo stato attuale, ad esempio una porta in modalità di manutenzione), 429 Too Many Requests (troppe richieste in poco tempo) |
| 5xx | Un errore del server | 500 Server Error, 502 Bad Gateway, 503 Service Unavailable |
Badge di origine
Ogni richiesta ha un badge di origine che ne indica la provenienza:
| Badge | Provenienza della richiesta |
|---|---|
web | Una persona che usa il Performance Hub in un browser o nell'app |
api-key | Un'integrazione che usa una chiave API, come un sistema di prenotazione o di gestione dei membri. Vedi Autenticazione della Partner API. |
mcp | Un agente AI o un client AI connesso tramite MCP. Vedi Uso con l'AI. |
model-router | Il Model Router |
websocket | Una connessione attiva, come un aggiornamento in tempo reale |
guest-token | Un link per ospiti |
Possono comparire altri badge.
Pagine correlate
- Trovare le richieste: filtra l'elenco
- Esportare i registri: scarica i registri caricati
- Esempi di indagine: metti in pratica i dettagli
- Registri di controllo: domande frequenti