La pestaña Request logs del
Developer Hub muestra el tráfico de la API /v1 de su
organización: estadísticas resumidas de las últimas 24 horas (número de
solicitudes, tasa de errores y solicitudes limitadas por frecuencia) sobre un
registro con función de búsqueda de las solicitudes individuales.
Qué registra cada entrada
La tabla del registro muestra la hora, el método HTTP, la ruta, el estado de la respuesta, la decisión de política, la latencia y el ID de solicitud de cada llamada. Al abrir una entrada se muestra el detalle completo, incluidos la cuenta de servicio y la clave de API que realizaron la llamada, la IP de origen y los permisos vigentes.
La decisión de política indica cómo se gestionó la solicitud:
- Allowed: la solicitud fue autenticada y autorizada.
- Denied: la solicitud fue rechazada, por ejemplo, porque la clave no tenía el permiso necesario, había caducado o estaba revocada.
- Rate limited: la solicitud superó un límite de solicitudes y fue rechazada con un
429. Consulte los límites de frecuencia.
Filtrar y buscar
Acote el registro por cuenta de servicio, clave de API, método HTTP, clase de estado (2xx–5xx), decisión de política, intervalo de tiempo o prefijo de ruta (por ejemplo, /v1/entities).
Rastrear un error por ID de solicitud
Cada respuesta de la API incluye un encabezado Request-Id, y el cuerpo de cada error contiene el mismo valor en su campo request_id. Pegue ese valor en el buscador del registro de solicitudes para ir directamente a la entrada correspondiente y ver exactamente cómo se gestionó la solicitud.
Cuando una integración notifique un error, solicite el request_id de la respuesta de error. Es el camino más rápido desde el síntoma observado por el cliente hasta el registro autorizado de lo ocurrido, y es el valor que debe incluir si se pone en contacto con el soporte de Living Security.
Detectar problemas a tiempo
- Un aumento de la tasa de errores suele indicar que una clave caducó, fue revocada o perdió un permiso que necesita; filtre por decisión para encontrar la credencial que falla.
- Un aumento del número de solicitudes limitadas por frecuencia significa que una carga de trabajo está funcionando al límite; consulte los límites de frecuencia para conocer estrategias de suavizado.
- El tráfico de una cuenta de servicio que debería estar inactiva es una señal para comprobar si sus credenciales se encuentran donde usted cree, y para deshabilitar la cuenta mientras investiga.
