> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Log delle richieste

> Tracciare, filtrare e risolvere i problemi del traffico della Public API di Living Security della propria organizzazione dal Developer Hub.

La scheda **Request logs** del
[Developer Hub](/it/developers/developer-hub/overview) 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](/it/developers/v1/rate-limits).

## 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.

<Tip>
  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.
</Tip>

## 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](/it/developers/v1/rate-limits) 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](/it/developers/developer-hub/service-accounts) durante
  l'analisi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.