A guia Request logs do
Developer Hub exibe o tráfego da API /v1
da sua organização: estatísticas resumidas das últimas 24 horas —
número de solicitações, taxa de erros e solicitações com limitação de taxa — acima de um
log pesquisável de solicitações individuais.
O que cada entrada registra
A tabela de logs mostra o horário, o método HTTP, o caminho, o status da resposta, a decisão de política, a latência e o ID da solicitação de cada chamada. Ao abrir uma entrada, são exibidos
todos os detalhes, incluindo a conta de serviço e a chave de API que fizeram a chamada,
o IP de origem e as permissões em vigor.
A decisão de política indica como a solicitação foi tratada:
- Allowed — a solicitação foi autenticada e autorizada.
- Denied — a solicitação foi recusada, por exemplo, porque a chave não tinha
a permissão necessária, estava expirada ou havia sido revogada.
- Rate limited — a solicitação excedeu um limite de solicitações e foi recusada
com um
429. Consulte os limites de taxa.
Filtrar e pesquisar
Refine o log por conta de serviço, chave de API, método HTTP, classe de status
(2xx–5xx), decisão de política, intervalo de tempo ou prefixo de caminho (por exemplo,
/v1/entities).
Rastrear um erro pelo ID da solicitação
Toda resposta da API contém um cabeçalho Request-Id, e todo corpo de erro
contém o mesmo valor no campo request_id. Cole esse valor na pesquisa do
log de solicitações para ir diretamente à entrada correspondente e ver exatamente
como a solicitação foi tratada.
Quando uma integração relatar um erro, solicite o request_id presente na
resposta de erro. É o caminho mais rápido entre um sintoma observado pelo cliente e o
registro autoritativo do que aconteceu — e o valor a ser informado ao
entrar em contato com o suporte da Living Security.
- Uma taxa de erros crescente geralmente significa que uma chave expirou, foi revogada ou perdeu
uma permissão necessária — filtre por decisão para encontrar a credencial com falha.
- Uma contagem crescente de solicitações com limitação de taxa significa que uma carga de trabalho está operando no limite; consulte
os limites de taxa para conhecer estratégias de suavização.
- O tráfego de uma conta de serviço que deveria estar inativa é um sinal para verificar
se as credenciais dela estão onde você imagina — e para
desativar a conta enquanto
você investiga.