O separador Request logs do
Developer Hub apresenta o tráfego da API /v1
da sua organização: estatísticas resumidas das últimas 24 horas —
número de pedidos, taxa de erros e pedidos com limitação de taxa — acima de um registo
pesquisável de pedidos individuais.
O que cada entrada regista
A tabela de registos mostra a hora, o método HTTP, o caminho, o estado da resposta, a decisão de política, a latência e o ID do pedido de cada chamada. Ao abrir uma entrada, é apresentado
o detalhe completo, incluindo a conta de serviço e a chave de API que efetuaram a chamada,
o IP de origem e as permissões que estavam em vigor.
A decisão de política indica como o pedido foi tratado:
- Allowed — o pedido foi autenticado e autorizado.
- Denied — o pedido foi recusado, por exemplo porque a chave não tinha
a permissão necessária, tinha expirado ou foi revogada.
- Rate limited — o pedido excedeu um limite de pedidos e foi recusado
com um
429. Consulte os limites de taxa.
Filtrar e pesquisar
Restrinja o registo por conta de serviço, chave de API, método HTTP, classe de estado
(2xx–5xx), decisão de política, intervalo de tempo ou prefixo de caminho (por exemplo,
/v1/entities).
Rastrear um erro pelo ID do pedido
Cada resposta da API contém um cabeçalho Request-Id e cada corpo de erro
contém o mesmo valor no campo request_id. Cole esse valor na pesquisa do
registo de pedidos para aceder diretamente à entrada correspondente e ver exatamente
como o pedido foi tratado.
Quando uma integração reportar um erro, solicite o request_id da
resposta de erro. É o caminho mais rápido entre um sintoma do lado do cliente e o
registo de referência do que aconteceu — e o valor a incluir se
contactar o suporte da Living Security.
Detetar problemas atempadamente
- Um aumento da taxa de erros significa normalmente que uma chave expirou, foi revogada ou perdeu
uma permissão de que necessita — filtre por decisão para encontrar a credencial com falhas.
- Um aumento do número de pedidos com limitação de taxa significa que uma carga de trabalho está a ter demasiada atividade; consulte os
limites de taxa para estratégias de distribuição do tráfego.
- O tráfego de uma conta de serviço que deveria estar inativa é um sinal para verificar
se as respetivas credenciais estão onde pensa — e para
desativar a conta enquanto
investiga.