La scheda Request logs del
Developer Hub mostra il traffico API /v1 della vostra
organizzazione: statistiche riepilogative relative alle ultime 24 ore —
numero di richieste, percentuale di errori e richieste soggette a limitazione della frequenza — sopra un
log consultabile delle singole richieste.
Che cosa registra ogni voce
La tabella del log mostra per ogni chiamata l’ora, il metodo HTTP, il percorso, lo stato della risposta, la decisione della policy, la latenza e l’ID della richiesta. L’apertura di una voce mostra
i dettagli completi, tra cui l’account di servizio e la chiave API che hanno effettuato la chiamata,
l’IP di origine e le autorizzazioni in vigore.
La decisione della policy indica come è stata gestita la richiesta:
- Allowed — la richiesta è stata autenticata e autorizzata.
- Denied — la richiesta è stata rifiutata, ad esempio perché alla chiave mancava
l’autorizzazione necessaria, perché era scaduta o perché era stata revocata.
- Rate limited — la richiesta ha superato un limite di richieste ed è stata rifiutata
con un
429. Consultare i limiti di frequenza.
Filtrare e cercare
È possibile restringere il log per account di servizio, chiave API, metodo HTTP, classe di stato
(2xx–5xx), decisione della policy, intervallo di tempo o prefisso del percorso (ad esempio
/v1/entities).
Tracciare un errore tramite l’ID della richiesta
Ogni risposta dell’API contiene un’intestazione Request-Id e ogni corpo di errore
riporta lo stesso valore nel campo request_id. Incollando tale valore nella ricerca del
log delle richieste si accede direttamente alla voce corrispondente e si vede esattamente
come è stata gestita la richiesta.
Quando un’integrazione segnala un errore, richiedete il valore request_id presente nella
risposta di errore. È il percorso più rapido per passare da un sintomo rilevato dal cliente al
record autorevole di ciò che è accaduto, nonché il valore da fornire se contattate il supporto di Living Security.
Individuare tempestivamente i problemi
- Un aumento della percentuale di errori indica di solito che una chiave è scaduta, è stata revocata o ha perso
un’autorizzazione necessaria: filtrate per decisione per individuare la credenziale che genera gli errori.
- Un aumento del numero di richieste soggette a limitazione della frequenza indica che un carico di lavoro è troppo intenso; consultate i
limiti di frequenza per le strategie di livellamento.
- Il traffico proveniente da un account di servizio che dovrebbe essere inattivo è un segnale per verificare
se le sue credenziali si trovano dove si ritiene, e per
disabilitare l’account durante
l’analisi.
