Trovare le richieste
In questa pagina
La scheda Logs elenca le richieste effettuate nella tua organizzazione, a partire dalla più recente. Usa i filtri in alto per restringere l'elenco a una persona, un indirizzo IP, una parte del Performance Hub o un tipo di risultato, quindi fai clic su una richiesta per vederne i dettagli.
Riferimento rapido
Dove trovarlo: Settings (icona a forma di ingranaggio, in basso a sinistra) → Registri di controllo → Logs
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: trovare le richieste alla base di una domanda, ad esempio chi ha modificato qualcosa o perché qualcosa non è andato a buon fine
Figura 1: la scheda Logs: i filtri in alto, le richieste corrispondenti a sinistra e la richiesta selezionata a destra
La scheda Logs
- Barra dei filtri: i filtri in alto, con Live, l'aggiornamento ed Esporta CSV a destra.
- Elenco: le richieste corrispondenti, a partire dalla più recente. Sopra l'elenco compare "Viewing logs for 1 organisation" (o il numero di organizzazioni che puoi vedere). Ogni riga mostra il codice di stato, il metodo, il badge di origine, la data e l'ora, l'endpoint, l'indirizzo email dell'utente e il tempo di risposta in millisecondi.
- Dettagli: la richiesta che hai selezionato. Vedi Leggere una voce del registro.
L'elenco carica altre richieste mentre scorri. Alla fine dell'elenco viene indicato quante richieste corrispondono, ad esempio "End of results · 5 logs".
Filtrare l'elenco
- Fai clic su un filtro nella barra dei filtri, ad esempio Endpoint.
- Scegli un'opzione o digita un valore. Ad esempio, digita
/api/door-gate-access/*in Endpoint e fai clic su Apply. - Il filtro mostra il valore scelto e l'elenco si aggiorna. Aggiungi altri filtri per restringerlo ulteriormente: una richiesta deve corrispondere a tutti i filtri per comparire.
- Per rimuovere un filtro, fai clic sulla × del filtro. Per rimuoverli tutti, fai clic su Clear, che compare non appena imposti un filtro.
Figura 2: la barra dei filtri: Range, Email, IP, Endpoint, Org, Facility, Method e Status, poi Live, aggiornamento ed Esporta CSV
| Filtro | Cosa confronta |
|---|---|
| Range | Il momento in cui è stata effettuata la richiesta. Il valore predefinito è Last 24 hours. Vedi Range. |
L'indirizzo email completo dell'utente, ad esempio priya.shah@example.com. Durante la digitazione può suggerire degli indirizzi. | |
| IP | L'indirizzo IP completo da cui proviene la richiesta, ad esempio 203.0.113.140 |
| Endpoint | La parte del Performance Hub a cui era destinata la richiesta. Corrisponde qualsiasi parte del percorso e puoi usare il carattere jolly *. Vedi Endpoint e caratteri jolly. |
| Org | Una sola organizzazione oppure Any org. Compare quando hai accesso ad almeno un'organizzazione. |
| Struttura | Una sola struttura oppure Any facility. Compare quando hai accesso ad almeno una struttura. |
| Method | GET, POST, PUT, PATCH o DELETE |
| Status | Lo stato della risposta. Vedi Status. |
Email e IP richiedono il valore completo
Email e IP trovano solo le corrispondenze esatte. Digita l'indirizzo email completo, come ruby.castellano@example.com, oppure l'indirizzo IP completo. Una parte di un indirizzo, come ruby o 203.0.113, non trova nulla.
Per trovare una persona senza conoscerne l'indirizzo completo, usa Top Users nel pannello di controllo, oppure apri una delle sue richieste e copia l'indirizzo dal campo User.
Intervallo
Fai clic su Range per scegliere fino a quando risalire nel tempo.
- Valori predefiniti: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days e Last 90 days.
- Date: scegli una data di inizio e una data di fine nel calendario di due mesi, quindi fai clic su Apply. Fai clic su Cancel per chiudere il menu senza modificare l'intervallo. Non è possibile scegliere date di oltre 90 giorni fa.
La nota in fondo al menu indica per quanto tempo vengono conservati i registri: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."
Figura 3: Range: scegli un valore predefinito o delle date nel calendario. La nota indica per quanto tempo vengono conservati i registri
Endpoint e caratteri jolly
L'endpoint è il percorso a cui è stata inviata la richiesta, come /api/door-gate-access/doors/front-entrance/unlock. Indica a quale parte del Performance Hub era destinata la richiesta.
- Senza
*, corrisponde qualsiasi parte del percorso. Ad esempio,unlocktrova tutte le richieste che contengono "unlock" nel percorso. - Con
*, ogni porzione tra gli asterischi deve comparire nel percorso. Ad esempio,/api/door-gate-access/*trova tutte le richieste di Door & Gate Access e/partner/v1/*trova tutte le richieste di un'integrazione che usa la Partner API.
Figura 4: Endpoint accetta il carattere jolly *, ad esempio per tutte le richieste relative alle porte
Figura 5: l'elenco dopo il filtro per un modello di endpoint
Non sai quale endpoint usare? Apri una richiesta che conosci, come una porta che hai sbloccato tu stesso, e copia la parte iniziale del suo endpoint dai dettagli.
Stato
Fai clic su Status per filtrare in base allo stato della risposta. Digita in Search… per trovare rapidamente uno stato, ad esempio "403". Scegli Any per mostrare tutti gli stati.
Gli stati sono elencati con il loro nome, come 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error e 503 Service Unavailable. Vedi Codici di stato per il loro significato.
Figura 6: filtrare in base allo stato della risposta
Live e aggiornamento
Nella scheda Logs, Live è impostato su Off per impostazione predefinita, così l'elenco resta fermo mentre indaghi. Attivalo e scegli ogni quanto aggiornare l'elenco per vedere arrivare le nuove richieste. Fai clic sul pulsante di aggiornamento (le frecce circolari) per ricaricare l'elenco una volta.
Condividere o salvare tra i preferiti una vista filtrata
I filtri vengono salvati nell'indirizzo della pagina. Aggiungi la pagina ai preferiti per tornare alla stessa vista oppure invia l'indirizzo a un collega. Vedrà lo stesso elenco filtrato se ha accesso a Registri di controllo e alla stessa organizzazione.
Ad esempio, un indirizzo che termina con /audit-logs/logs?email=priya.shah%40example.com apre l'elenco filtrato per quella persona, mentre uno che termina con /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* apre tutte le richieste relative alle porte.
Spostarsi nell'elenco
- Fai clic su una richiesta per aprirne i dettagli a destra.
- Usa i tasti freccia su e giù per passare alla richiesta precedente o successiva nell'elenco.
- Su uno schermo stretto, i dettagli si aprono sopra l'elenco. Fai clic sul pulsante di chiusura per tornare all'elenco.
Nessun risultato
Se non c'è alcuna corrispondenza, l'elenco mostra "No logs match these filters" e "Try widening the time range or clearing a filter."
Figura 7: nessuna richiesta corrispondente: amplia l'intervallo o rimuovi un filtro
Per trovare ciò che cerchi:
- Scegli un Range più lungo, come Last 7 days.
- Verifica che Email e IP contengano l'indirizzo completo. Una parte di un indirizzo non trova nulla.
- Rimuovi un filtro alla volta con la relativa × oppure fai clic su Clear.
Pagine correlate
- Leggere una voce del registro: cosa mostra ogni richiesta
- Esportare i registri: scarica l'elenco come file CSV
- Esempi di indagine: i filtri per le domande più comuni
- Il pannello di controllo: fai clic su un grafico per aprire i registri corrispondenti