Registro de eventos del sistema

Los “logs del sistema” de Trazo no son un volcado de texto: son eventos relevantes, agrupados. Una misma falla cae siempre en la misma fila (por su huella) y suma a su contador, en lugar de llenar la pantalla de repetidos. Solo el Super admin los ve (system.logs.view).

Qué se registra: errores 500, jobs que fallan, piezas caídas (Redis, Reverb, worker) y cola acumulada, ingresos bloqueados, MFA cortado por intentos, códigos de recuperación de contraseña anulados, Have I Been Pwned sin responder, reautenticación bloqueada y 10 accesos denegados en 5 minutos. No se registran tokens vencidos, errores de validación, 404 normales ni intentos de ingreso aislados.

Paso a paso

1. 1
   OrigenOcurre algo relevante

   Desde cualquier módulo, por el puerto compartido SystemEvents, con el tipo y su origen (por ejemplo redis, o la cuenta enmascarada a***@dominio).

2. 2
   OrigenCalcula la huella del tipo y el origen

   SHA-256 de "tipo|origen". El contexto no lleva secretos; de un error de base de datos solo se guarda el SQLSTATE.

3. 3
   Base de datosInserta o suma en una sola sentencia

   INSERT … ON DUPLICATE KEY UPDATE: si la huella ya existe, sube occurrences, actualiza la última vez y el mensaje, y si estaba resuelto lo reabre. Nunca lanza: registrar un evento no puede tumbar la petición que lo originó.

4. 4
   Super adminAbre Sistema › Eventos

   Vista Pendientes, Resueltos o Todos, con severidad (info, warning, critical) y tipo; filtros en la dirección.

5. 5
   Super adminAbre un evento

   Mensaje, contexto, ocurrencias, primera y última vez y trace_id para buscarlo en los registros del servidor.

6. 6
   Super admin¿Qué hace con él?
7. 7
   Base de datosQueda revisado, con quién y cuándo

   Sigue sumando si vuelve a pasar.

8. 8
   Base de datosQueda resuelto hasta que se repita

   Si vuelve a ocurrir, se reabre solo. Los resueltos de más de 90 días se borran cada día (SYSTEM_EVENTS_RETENTION_DAYS).

Qué ve la persona en cada error

Dónde está en el código

• DatabaseSystemEvents y Fingerprint: registro agrupado.
• FailureEvents y bootstrap/app.php: errores 500.
• WatchDeniedAccess: accesos denegados repetidos.
• ManageSystemEvents: listar y cambiar el estado.
• useSystemEvents.
• Explicación: Módulo System.