Monitor de Eventos

Monitor de Eventos es el panel operativo para la infraestructura de mensajería asíncrona de la plataforma. Agrega estadísticas de outbox e inbox en el portal y todos los microservicios conectados, resalta los eventos fallidos (dead letters) que requieren atención y proporciona acciones de reintento, eliminación y purga para resolver fallos de procesamiento. El panel se actualiza automáticamente cada 30 segundos.

Solo acceso de administrador del sistema. Esta página está disponible exclusivamente para administradores del sistema. No es accesible desde el portal estándar del tenant.

Acceso a la Página

• Ruta: /outbox
• Ruta del menú: Configuración → Datos y Monitoreo → Monitor de Eventos
• Audiencia principal: Solo administradores del sistema. Se accede a través del inicio de sesión del administrador del sistema en system.portal.net, no desde el portal del tenant.

Qué puedes hacer aquí

• Ver estadísticas agregadas de outbox (Pendientes, En Proceso, Completados, Eventos Fallidos) en el portal y todos los microservicios registrados.
• Ver el estado de outbox por servicio en la tabla de Servicios y navegar a la lista de dead letters de cualquier servicio específico.
• Ver estadísticas de dead letters de inbox y el estado de inbox por servicio en la pestaña Inbox.
• Monitorear estadísticas de entrega de correos y dead letters de correos fallidos en la pestaña Correos.
• Reintentar eventos dead letter individuales para volver a ponerlos en cola para su procesamiento.
• Reintentar todos los eventos dead letter de un servicio en una sola operación.
• Eliminar eventos dead letter individuales de forma permanente.
• Purgar todos los eventos dead letter de un servicio en una sola operación (destructivo — requiere confirmación).

Tareas comunes

1. Abre Configuración → Datos y Monitoreo → Monitor de Eventos en system.portal.net.
2. Revisa la tarjeta de Resumen en la pestaña Outbox — si Eventos Fallidos es mayor que cero, investiga el servicio afectado.
3. En la tabla de Servicios, identifica qué servicio tiene eventos fallidos y haz clic en Ver Fallidos para abrir su lista de dead letters.
4. Revisa el tipo de evento, el mensaje de error y el conteo de reintentos para cada evento fallido.
5. Si se ha resuelto la causa raíz, haz clic en Reintentar en eventos individuales o Reintentar Todos para toda la cola.
6. Si un evento es permanentemente inprocesable, haz clic en Eliminar para removerlo de la cola.
7. Usa Purgar Todos solo cuando todos los dead letters de un servicio son seguros de descartar — la acción es irreversible.

Notas

• Las estadísticas se agregan de todos los microservicios que tienen el monitoreo de outbox configurado. Los servicios sin configuración de outbox no aparecen en la tabla de Servicios.
• El panel hace sondeos cada 30 segundos. La marca de tiempo de última actualización aparece en la parte inferior de cada tarjeta de Resumen.
• Los eventos dead letter mostrados en rojo indican fallos activos. Resolver el problema subyacente de servicio o payload antes de reintentar evita volver a fallar.
• La pestaña Inbox opera con el mismo patrón que Outbox pero rastrea fallos de procesamiento de mensajes entrantes.
• La pestaña Correos muestra estadísticas del servicio de entrega de correos y su cola de dead letters para mensajes que no pudieron entregarse.

Pestañas del panel

Pestaña Outbox

La pestaña Outbox es la vista predeterminada. Contiene dos secciones:

Tarjeta de Resumen General

Muestra conteos de eventos agregados de todos los servicios:

Métrica	Color	Qué muestra
Pendientes	Amarillo	Eventos en cola pero que aún no se han recogido para procesamiento
En Proceso	Azul	Eventos que se están despachando actualmente
Completados	Verde	Eventos procesados y entregados exitosamente
Eventos Fallidos	Rojo (cuando > 0)	Eventos que fallaron todos los intentos de reintento y requieren acción del operador

Un botón de actualización en el encabezado de la tarjeta activa una recarga inmediata de los datos.

Tabla de Servicios

Lista cada microservicio que tiene el monitoreo de outbox habilitado:

Columna	Descripción
Servicio	Nombre de visualización del microservicio
Pendientes	Conteo de eventos pendientes para este servicio
En Proceso	Conteo de eventos en proceso
Completados	Conteo de eventos completados
Fallidos	Conteo de eventos fallidos; resaltado en rojo cuando es mayor que cero
Estado	Indicador Saludable / Error basado en si existen eventos fallidos
Acciones	Botón Ver Fallidos — navega a la lista de dead letters limitada a ese servicio

Lista de Dead Letters

Al hacer clic en Ver Fallidos para un servicio se abre la página de gestión de dead letters limitada a ese servicio.

Columna	Descripción
ID	Identificador interno del evento (truncado)
Tipo de Evento	El tipo de mensaje que falló
ID de Correlación	Identificador de correlación para rastreo entre servicios
Reintentos	Cuántas veces se ha reintentado el evento
Último Error	El mensaje de error más reciente
Creado	Cuándo se creó el evento por primera vez
Acciones	Botones Reintentar, Eliminar por fila

Acciones a nivel de página: Reintentar Todos, Purgar Todos (requiere diálogo de confirmación). La paginación es de 20 filas por página con navegación anterior/siguiente.

Pestaña Inbox

Sigue la misma estructura que la pestaña Outbox pero rastrea fallos de procesamiento de mensajes entrantes. La tarjeta de Resumen muestra métricas de inbox agregadas y la tabla de Servicios muestra estadísticas de inbox por servicio.

Pestaña Correos

Vista dedicada para el servicio de entrega de correos:

• Una tarjeta Estadísticas de Correos muestra el conteo de dead letters de correos y la hora de última actualización.
• Una tabla Dead Letters de Correos lista los mensajes de correo fallidos individuales con sus detalles de error y acciones de reintento/eliminación por fila.

Reenvío de Eventos

Para reprocesar un evento dead letter después de resolver la causa raíz:

1. Localiza el evento en la lista de dead letters.
2. Haz clic en Reintentar en la fila. El evento vuelve al estado Pendiente y se pone en cola nuevamente.
3. Monitorea la tarjeta de Resumen — el conteo de Eventos Fallidos debería disminuir y los Pendientes/En Proceso deberían aumentar.
4. Si el evento falla de nuevo, regresa a la lista de dead letters con el conteo de reintentos incrementado.

Para reprocesar todos los dead letters de un servicio, haz clic en Reintentar Todos en el encabezado de la página. Un diálogo de confirmación muestra el conteo total antes de proceder.

Páginas relacionadas

• Micro Servicios — registro de servicios; verifica que todos los servicios estén activos antes de ejecutar operaciones de reintento
• Registro de Eventos — catálogo de tipos de eventos registrados y suscripciones de servicios