Saltar a contenido

RUNBOOK — job-monitor-athenas

Dato Valor
Job recibe_athenas_monitor (W22)
Programacion 20 8 * * * (todos los dias)
Comando .venv/bin/python -m monitor_athenas
Auditoria (ATHENAS.ods.tbl_control_procesos) ID08 - PY_RECIBE_DABRA_ATHENAS_MONITOR; Num_Registros = cantidad de controles con problema; estados Success / Error
Logs /var/log/dabra/recibe_athenas_monitor/
Duracion esperada ~2,5 min en el original (medir). Timeout propuesto: 20 min. Tolerancia 120 min (propuesta)
Codigo Significado Accion
0 El resumen se entrego a Telegram y se audito —
1 No se entrego el resumen a algun chat (tras 1 reintento; con TELEGRAM_FALLO_TOLERADO=true esto solo se loguea y sale 0), fallo inesperado o no se pudo auditar Ver el log; reejecutar. Si no llega el mensaje de las 08:20, mirar primero el panel
2 Configuracion invalida Revisar .env

Comandos

python -m monitor_athenas --dry-run   # ejecuta los 21 controles y deja el resumen en el log; no envia ni audita
python -m monitor_athenas             # produccion: envia a TELEGRAM_CHAT_IDS

Reproceso

Solo lectura: se puede repetir cuando se quiera. Cada ejecucion manda otro resumen al grupo y deja otra fila de auditoria.

Rollback

No hay.

Problemas conocidos

  • Un control que falla al consultar aparece como ❌ ERROR consultando: ... en el resumen y no impide los demas. Si todo falla a la vez (p. ej. ATHENAS caido) el resumen llega lleno de ❌.
  • El monitor no se vigila a si mismo: si el job no corre, nadie lo nota salvo el panel (RUN_MISSING). Ver pendientes en AGENTS.md.
  • Mensajes de mas de 4000 caracteres se parten en varios mensajes de Telegram (el original igual).
  • Las tablas de BYOD se consultan por el linked server [BYOD] de ATHENAS: la cuenta de ATHENAS_DB_URL necesita permiso sobre el.

Fuente: repositorio job-monitor-athenas, versión 8514099. Página generada con tools/publicar_docs.py.