Recibe una alerta cuando un cron job o un script programado de Python falla
Un script de Python se ejecuta cada noche desde cron o desde el Programador de tareas de Windows (Task Scheduler). Cuando lanza una excepción, el traceback va a un log o a un buzón que nadie lee, y te enteras cuando faltan los datos. Unas pocas líneas en el script te envían ese traceback a ti, y un horario detecta las ejecuciones que se cuelgan o nunca empiezan.
Python reporta el fallo; el programador de tareas se lo guarda
Una excepción no capturada hace que Python termine con el estado 1 (la documentación de Python sobre sys.exit y el bucle principal del intérprete lo describe: 0 es éxito, cualquier otro valor es una terminación anormal). Así que el programador de tareas sí lo sabe. Lo que hace con eso:
- cron no mira el estado de salida en absoluto. Envía por correo la salida del job al propietario del crontab o a
MAILTO, si la máquina tiene un programa de correo que funcione; cronie escribe la salida en syslog cuando no lo tiene. Un script que falla con la salida redirigida a un archivo no envía nada a ningún lado. - Task Scheduler muestra
0x1en la columna Last Run Result (resultado de la última ejecución), y nada más. Hilos de foros como “How to fix (0x1) error in task scheduler that runs a python script” (Microsoft Q&A, 2023) empiezan con alguien que se da cuenta días después.
Algunos fallos no son excepciones en absoluto: un try/except que registra y sigue, una API que devuelve una lista vacía, una consulta que no encuentra filas nuevas. Python termina con 0 y el programador de tareas queda conforme. Y una ejecución que nunca empezó (máquina apagada, demonio de cron caído, ruta equivocada en el crontab) no deja ningún estado.
Reporta desde el script
El código de abajo usa solo la biblioteca estándar (urllib), así que funciona en cualquier Python 3 y en cualquier entorno virtual. Hace ping a TaskBeacon al empezar; ante una excepción envía /fail con el error y las últimas 20 líneas del traceback, y luego vuelve a lanzarla para que el estado de salida siga siendo 1; al final envía el conteo de filas.
# --- TaskBeacon: top of the script (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(df)})En la app, la pestaña Code (código) de tu job te da este código con la dirección propia del job en lugar de your-job-id, y puedes desmarcar las partes que no necesites.
Reemplaza la línea de ejemplo por tu código y guarda el resultado en df (un DataFrame de pandas o una lista de filas), o envía otro número. Un ping fallido imprime un mensaje y el script sigue: el monitoreo nunca rompe el job.
Para un cron job, la línea del crontab se queda como está:
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py >> /home/me/jobs/sales.log 2>&1
Si prefieres no tocar el script, la línea de cron reporta en su lugar el código de salida (sin el traceback ni el conteo de filas).
Qué obtienes
- Failed (fallido) con la excepción y el final del traceback, por ejemplo
KeyError: 'amount', en tu correo, Slack o Teams. - Missed (no ejecutado) cuando no llegó ningún ping antes de la hora prevista más el margen: máquina apagada, cron sin ejecutarse, un error de tipeo en el crontab.
- Late (retrasado) cuando el script empezó y está tardando mucho más de lo habitual, como una solicitud sin timeout esperando para siempre.
- Odd data (datos raros) cuando las filas caen más de un 40 % o son 0.
Sin TaskBeacon
En Linux, instala y configura un programa de correo, define MAILTO y haz que el script solo imprima cuando haya errores, para que cron te envíe un correo exactamente en ese momento. En Windows, añade un try/except en el nivel superior que envíe un correo con smtplib antes de volver a lanzar la excepción. Ambos cubren las excepciones. Ninguno cubre una ejecución que nunca empezó; para eso necesitas algo que espere una señal del job, una comprobación de heartbeat, o un segundo job que revise cada mañana la salida del primero.
¿Conectaste Claude o ChatGPT a TaskBeacon? Pregúntale “¿qué falló anoche y por qué?” y te responde a partir de tus jobs. Cómo funciona.
Relacionado
En la documentación: Python · Linux cron · Estados.
- Monitoreo heartbeat (dead man's switch) para scripts programadosEl job avisa en cada ejecución; el silencio es la alerta.
- Entérate cuando falla un script de R programadotaskscheduleR y cron escriben un log; nadie lo lee hasta que algo sale mal.
- Recibe una alerta cuando un job carga 0 filas o muchas menos de lo habitualEl código de salida 0 no dice nada de cuántas filas llegaron.
Todos los casos de uso · Preguntas frecuentes
Empezar con TaskBeacon es gratis, por ahora con todas las funciones abiertas y sin tarjeta de crédito. Crea un job, pega el código y el primer ping aparece en la página del job.
Empieza gratis Ver demo en vivoFuentes
- Python docs: Py_RunMain devuelve 1 ante una excepción no controlada (Documentación de Python 3.15, sin fecha; revisado el 9 de noviembre de 2026)
- Python docs: sys.exit (cero es éxito, distinto de cero es terminación anormal) (Documentación de Python 3.15, sin fecha; revisado el 9 de noviembre de 2026)
- man7.org: crontab(5), cronie (MAILTO) (página de 2012, coincide con cronie upstream 2026)
- man7.org: cron(8), cronie (la salida se envía por correo; sin sendmail va a syslog) (página de 2013, coincide con cronie upstream 2026)
- Microsoft Q&A: How to fix (0x1) error in task scheduler that runs a python script (28 de agosto de 2023, antiguo: señal de demanda)
Página revisada contra sus fuentes el 9 de noviembre de 2026. Los menús y límites de otros productos cambian; si algo aquí ya no coincide, escribe a support@taskbeacon.io.