Backend
1. Objetivo de la vista
La sección Logs → Backend permite visualizar en tiempo real el historial de peticiones que se realizan contra la API de LIRA.
Es la herramienta principal para:
Auditar quién llamó qué endpoint y desde qué IP.
Monitorear el comportamiento de integraciones externas.
Investigar errores (4xx/5xx) y tiempos de respuesta.
2. Estructura general
En la parte superior verás:
Pestañas:
Backend (vista actual): logs de la API del backend de LIRA.
Nodo (cuando aplique): vista alternativa con logs a nivel de infraestructura/nodos.
Selector de rango de fechas: define desde/hasta qué día quieres ver los logs.
Ejemplo: 27 Nov, 2025 – 27 Nov, 2025.
Búsqueda por usuario: campo Buscar usuarios para filtrar por correo del usuario autenticado que hizo la petición.
Filtros rápidos (dropdowns):
Estado: filtra por código HTTP (200, 400, 401, 500, etc.).
Método: filtra por método HTTP (GET, POST, PUT, DELETE, etc.).
Botón de recarga: actualiza la tabla con los datos más recientes según los filtros actuales.
3. Tabla de logs
La tabla central muestra una fila por cada petición registrada:
Columnas principales:
ID
Identificador interno del log (ej. BA81, F462). Sirve para referencia rápida cuando se necesita compartir un caso con el equipo técnico.
IP
Dirección IP desde la que se realizó la llamada a la API.
User
Usuario autenticado que ejecutó la petición (generalmente un correo).
Si es una integración de terceros, corresponderá al usuario técnico o servicio asignado.
Method
Método HTTP de la petición. Se muestra como una etiqueta de color (por ejemplo, GET, POST).
Path
Ruta del endpoint llamado, por ejemplo:
/api/loan/{id}/transactions
/api/financial-product/{product_id}
/api/loan/search
Status
Código de respuesta HTTP (ej. 200, 400, 401, 500).
Suele mostrarse con una pastilla de color para distinguir fácilmente respuestas exitosas de errores.
Happened
Hace cuánto tiempo ocurrió la petición (ej. 15 seconds, 35 seconds, etc.).
Browser
Navegador y versión desde el cual se originó la llamada (por ejemplo Chrome 142).
En integraciones de backend puede representar el agente de usuario del cliente.
Actions
Columna de acciones rápidas. El icono de “ojo” (👁) permite abrir el detalle del log, donde se puede profundizar en la información de esa petición específica (por ejemplo, payload, headers o mensaje de error, según lo que se registre en tu instancia).
En la parte inferior:
Se muestra el total de registros cargados en la página (ej. 100 doc(s)).
Controles de paginación (‹ 1 ›) para navegar entre páginas de resultados.
4. Cómo usar esta vista en la práctica
Algunos flujos típicos:
Investigar un error de integración
Filtra por rango de fechas cuando ocurrió el fallo.
Usa el filtro de Estado para mostrar sólo códigos 4xx o 5xx.
Opcionalmente filtra por usuario o método.
Localiza la fila del error y abre el detalle desde la columna Actions.
Auditar consumo de API por un cliente o usuario
Filtra por correo en Buscar usuarios.
Ajusta el rango de fechas.
Revisa las rutas (Path) más utilizadas y los estados de respuesta.
Verificar llamadas recientes después de un cambio
Usa la fecha actual.
Pulsa el botón de recarga para refrescar los logs.
Ordena visualmente por columna de tiempo (Happened) y revisa las últimas llamadas.
5. Buenas prácticas
Mantener filtros de fecha lo más acotados posible para que la vista sea rápida y manejable.
Ante errores recurrentes de un mismo endpoint o usuario, exportar/registrar los IDs de log relevantes y compartirlos con el equipo técnico.
Utilizar esta vista junto a la documentación de la API de LIRA para entender si el fallo viene de parámetros incorrectos, permisos insuficientes o problemas de negocio.
Last updated