Operación
Bitácora, alertas y alarmas
La bitácora registra una línea por cada ejecución de un proceso: qué entró, qué salió, estado, duración y, según el nivel, el paso a paso.
Es distinta del log de texto del motor, que registra eventos técnicos.
Niveles
El Log Level del canal decide cuánto se graba:
| Nivel | Qué graba |
|---|---|
| SinLog | Nada. |
| Intermedio | Solo las fallidas. |
| Alto | Todas, con paso a paso resumido. |
| Completo | Todas, con paso a paso íntegro, funciones evaluadas y request/response de cada Task. |
Un proceso masivo puede fijar su propio nivel (Bitácora de este proceso → Resumen, Solo errores, Nada, Alto o Completo) para no llenar la bitácora ni la memoria; Resumen es la opción recomendada cuando el detalle por registro ya queda en otro lado. Si el paso a paso de una ejecución pasa de 16 MB se omite y el log sugiere Resumen.
Consultar
Consola → Bitácora lista de la más nueva a la más vieja; clic en una fila abre la trama completa y el árbol de pasos. Buscar por valor busca dentro de las tramas (un contrato, una placa). La traza por proceso se activa en la pestaña Traza y devuelve el paso a paso completo mientras esté activa. Reejecutar vuelve a correr una transacción con su entrada original (ejecución real, con confirmación).
Retención
Un janitor comprime log y bitácora a los 7 días y borra o archiva según log-retencion-dias, bitacora-retencion-dias y bitacora-archivo-ruta; por defecto nunca borra. También hay borrado manual por día o completo, con confirmación y auditado.
Alertas y alarmas
Avisan cuando un backend deja de responder, no por reglas de negocio. Cada Servidor lleva un contador de fallos de transporte consecutivos (no conectar, timeout, lectura fallida, sin instancia libre a tiempo); al llegar al umbral dispara y se reinicia.
Se configura en el Servidor con Alarma, TransaccionesFallidas e IntervaloAlarma (cooldown). Destinos: siempre el log y /admin/alertas; opcionalmente un webhook (POST JSON con token Bearer) y correo por un servidor SMTP del proyecto. Sin configurar nada, un servidor con todas sus instancias ocupadas durante 30 segundos también avisa. Un HTTP 4xx o 5xx completo cuenta como comunicación exitosa; errores de BD, MQ y correo salen como Fault del Task y no suman.