Nodo

La sección Logs → Nodo permite monitorear las peticiones que pasan por los nodos y servicios internos de LIRA (por ejemplo: servicios de chat, procesos orquestados, workers, etc.).

Es útil para:

  • Ver cómo se están usando estos servicios por parte de tus usuarios o integraciones.

  • Revisar rendimiento (duración de las peticiones).

  • Investigar errores o comportamientos inusuales en flujos que pasan por estos nodos.


2. Estructura general de la pantalla

En la parte superior encontrarás:

  • Pestañas

    • Backend: logs de la API principal.

    • Nodo: (vista actual) logs de servicios/nodos internos.

  • Barra de filtro global

    Campo de texto:

    “Filtrar por método, ruta, estado, correo o valor de clave”

    Permite buscar rápidamente por cualquiera de esos criterios en todos los registros.

  • Filtros avanzados

    • Seleccionar clave…

      Permite filtrar por una clave específica registrada en el log (por ejemplo, un ID de operación, un código de cliente, etc., según la configuración de tu instancia).

    • Buscar usuarios

      Filtra por correo o identificador del usuario asociado a la llamada.

    • 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 logs más recientes respetando los filtros activos.


3. Tabla de logs de nodo

Cada fila representa una llamada registrada en los nodos/servicios:

  • ID

    Identificador interno del log (ej. Y0K9, LU9N). Es útil para referenciar un caso concreto al soporte técnico.

  • Correo electrónico

    Usuario asociado a la llamada (por ejemplo, [email protected] o admin).

    En integraciones máquina a máquina se verá el usuario técnico configurado para ese cliente.

  • Método

    Método HTTP (POST, GET, etc.), mostrado como etiqueta de color para distinguirlos visualmente.

  • Ruta

    Endpoint específico del nodo que fue llamado, por ejemplo:

    • /api/chat/userStatus

    • /api/statistics

  • Estado

    Código de respuesta HTTP (200, 4xx, 5xx).

    Ayuda a separar rápidamente respuestas correctas de errores.

  • Duración

    Tiempo que tomó procesar la petición (ej. 144 ms, 1695 ms).

    Es útil para detectar problemas de rendimiento o cuellos de botella.

  • Marca de tiempo

    ¿Hace cuánto tiempo ocurrió la petición (ej. 5 minutes, 3 hours, etc.)?

  • Acciones

    • Icono de ojo (👁): permite abrir el detalle del log (cuando esté disponible) para ver información adicional de la petición.

    • Menú adicional (⋯) para acciones avanzadas según tu configuración (por ejemplo, copiar ID, exportar, etc.).

También puedes seleccionar varias filas con los checkbox de la primera columna si en el futuro se habilitan acciones masivas (p.ej. exportar registros).


4. Casos de uso habituales

  1. Monitorear el servicio de chat o nodos específicos

    • Usa el filtro de texto global y escribe parte de la ruta (ej. chat/userStatus).

    • Filtra por Estado = 200 para verificar que todo responde bien.

    • Revisa las columnas de Duración para identificar peticiones lentas.

  2. Investigar errores en integraciones de nodo

    • Filtra por Estado (por ejemplo, 4xx o 5xx).

    • Opcionalmente filtra por Correo electrónico del usuario o servicio.

    • Abre el detalle desde la columna Acciones para ver más información técnica.

  3. Auditar uso por usuario

    • En Buscar usuarios, escribe el correo del usuario.

    • Revisa las rutas que está usando con más frecuencia, su estado y la duración de las llamadas.


5. Buenas prácticas

  • Combina el filtro global con los filtros de Estado y Método para reducir el ruido y encontrar exactamente lo que buscas.

  • Si detectas un patrón de errores (por ejemplo, mismas rutas devolviendo 4xx/5xx), recopila los IDs afectados y compártelos con el equipo de soporte o desarrollo.

  • Utiliza la columna Duración para detectar endpoints que podrían requerir optimización o caching en tu integración.

Last updated