Errores de correo claros y healthcheck #4

Open
hectorviov wants to merge 1 commit from feat/errores-de-correo-y-healthcheck into main
Owner

Del 29 de octubre al 9 de noviembre no salió ningún correo y nadie se enteró: el contenedor siguió healthy y en docker logs solo había un traceback largo de smtplib (Connection unexpectedly closed). La causa era SMTP_USER apuntando a un alias de Gmail, algo que el error no decía.

Qué cambia

  • Errores claros. send_mail traduce los errores de smtplib a MailError con la causa probable en español: login rechazado (con el código), conexión cortada por Gmail (sugiere revisar que SMTP_USER sea la cuenta principal y no un alias), sin conexión al servidor y otros errores SMTP. Los mensajes nunca incluyen la contraseña.
  • Una línea en vez del traceback. monitor.py y weekly_report.py corren con run_cli(main): imprimen ERROR: no se pudo enviar el correo. <causa> y salen con código 1. Cualquier otro error conserva su traceback.
  • Healthcheck. .status.json guarda el resultado del último correo y de la última corrida del monitor. healthcheck.py falla si el último correo falló o si el monitor lleva más de 15 min sin correr, y el contenedor pasa a unhealthy (visible en Unraid) con el motivo en docker inspect.
  • monitor.py --test-mail. Manda un correo de prueba a ALERT_MAIL_TO. Confirma que el SMTP funciona y limpia un fallo ya resuelto.

Notas

  • El monitor sigue sin guardar su estado si falla el envío de una alerta, así que la reintenta en la siguiente corrida (cada 5 min).
  • El healthcheck solo marca el contenedor, no manda ningún aviso por sí mismo; está en el README.
  • Un fallo de correo queda marcado hasta el siguiente envío exitoso. Después de corregir el .env, correr --test-mail lo limpia sin esperar al sábado.

Pruebas

  • 52 pruebas (eran 28): mensajes por tipo de error, que no se filtre la contraseña, estado de la falla y su limpieza, run_cli, healthcheck, reintento del monitor y --test-mail.
  • docker build --target test . pasa en Python 3.12 y la imagen final trae el HEALTHCHECK.
  • Probado de punta a punta con un SMTP inexistente: una línea de error, código 1 y el healthcheck con la causa.

🤖 Generated with Claude Code

Del 29 de octubre al 9 de noviembre no salió ningún correo y nadie se enteró: el contenedor siguió `healthy` y en `docker logs` solo había un traceback largo de `smtplib` (`Connection unexpectedly closed`). La causa era `SMTP_USER` apuntando a un alias de Gmail, algo que el error no decía. ## Qué cambia - **Errores claros.** `send_mail` traduce los errores de `smtplib` a `MailError` con la causa probable en español: login rechazado (con el código), conexión cortada por Gmail (sugiere revisar que `SMTP_USER` sea la cuenta principal y no un alias), sin conexión al servidor y otros errores SMTP. Los mensajes nunca incluyen la contraseña. - **Una línea en vez del traceback.** `monitor.py` y `weekly_report.py` corren con `run_cli(main)`: imprimen `ERROR: no se pudo enviar el correo. <causa>` y salen con código 1. Cualquier otro error conserva su traceback. - **Healthcheck.** `.status.json` guarda el resultado del último correo y de la última corrida del monitor. `healthcheck.py` falla si el último correo falló o si el monitor lleva más de 15 min sin correr, y el contenedor pasa a `unhealthy` (visible en Unraid) con el motivo en `docker inspect`. - **`monitor.py --test-mail`.** Manda un correo de prueba a `ALERT_MAIL_TO`. Confirma que el SMTP funciona y limpia un fallo ya resuelto. ## Notas - El monitor sigue sin guardar su estado si falla el envío de una alerta, así que la reintenta en la siguiente corrida (cada 5 min). - El healthcheck solo marca el contenedor, no manda ningún aviso por sí mismo; está en el README. - Un fallo de correo queda marcado hasta el siguiente envío exitoso. Después de corregir el `.env`, correr `--test-mail` lo limpia sin esperar al sábado. ## Pruebas - 52 pruebas (eran 28): mensajes por tipo de error, que no se filtre la contraseña, estado de la falla y su limpieza, `run_cli`, `healthcheck`, reintento del monitor y `--test-mail`. - `docker build --target test .` pasa en Python 3.12 y la imagen final trae el `HEALTHCHECK`. - Probado de punta a punta con un SMTP inexistente: una línea de error, código 1 y el healthcheck con la causa. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Errores de correo claros, healthcheck y --test-mail
All checks were successful
CI / test (pull_request) Successful in 13s
CI / deploy (pull_request) Has been skipped
c15412a116
- send_mail traduce los errores de smtplib a MailError con la causa probable
  en español (login rechazado, conexión cortada por Gmail, sin conexión)
- monitor.py y weekly_report.py dejan una sola línea de ERROR en vez del
  traceback y salen con código 1
- .status.json guarda el resultado del último correo y de la última corrida
  del monitor; healthcheck.py lo lee y el contenedor pasa a unhealthy si el
  correo falla o el monitor deja de correr
- monitor.py --test-mail manda un correo de prueba a ALERT_MAIL_TO

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
All checks were successful
CI / test (pull_request) Successful in 13s
Required
Details
CI / deploy (pull_request) Has been skipped
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'feat/errores-de-correo-y-healthcheck:feat/errores-de-correo-y-healthcheck'
git switch 'feat/errores-de-correo-y-healthcheck'
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
hectorviov/biotime-scripts!4
No description provided.