Python
Solo la biblioteca estándar (urllib). Funciona con cualquier Python 3. Ante un error envía el error y las últimas 20 líneas del traceback; la alerta Failed y la página de la tarea los muestran. La línea de ejemplo (df = ...) funciona tal como se pega: reemplázala por tu propio código.
El código
Este es el código que genera la pestaña Code (código) (con inicio, errores y filas marcado). En la app ya contiene la dirección propia de tu job.
# --- 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)})Cómo funciona
El código envía un ping a /start cuando el script empieza, a la dirección simple con el número de filas cuando termina bien, y a /fail cuando falla, con el error y las últimas 20 líneas del traceback.
Desmarca opciones en la pestaña Code para dejar partes fuera; desmarca Send output lines (enviar líneas de salida) para no enviar ninguna salida, solo el error o el código de salida. Consulta qué se puede informar.
Ejecutar un script de Python según un horario
En Windows, crea una tarea desde un Símbolo del sistema. Usa la ruta completa del Python en el que instalaste los paquetes (where python la muestra), o la de tu entorno virtual:
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "C:\jobs\venv\Scripts\python.exe C:\jobs\sales.py"
En Linux o en una Mac, una línea de crontab (crontab -e):
0 6 * * * /home/me/jobs/venv/bin/python /home/me/jobs/sales.py
Usa python.exe, no pythonw.exe, si quieres ver la salida cuando inicias la tarea a mano.
Por qué el código de salida no basta
Una excepción no capturada hace que Python termine con el código 1, así que el programador de tareas ve ese tipo de fallo. No ve los silenciosos: una consulta con resultado vacío, una API que respondió sin datos, un try/except que registra el error y sigue adelante, o una ejecución que nunca empezó porque la máquina estaba apagada.
El código de arriba envía /fail con el mensaje de error y las últimas 20 líneas del traceback, y luego vuelve a lanzar la excepción, así que el código de salida sigue siendo fiel; una ejecución que nunca empieza aparece como Missed (no ejecutado).
Reportar el número de filas
La última línea envía len(df). Reemplaza df por tu resultado (un DataFrame de pandas, una lista de filas, el número que devolvió tu insert). Más números van en el mismo JSON:
tb_ping("", {"rows": len(df), "total": float(df["amount"].sum())})
El código usa solo la biblioteca estándar (urllib), así que funciona sin requests.
Problemas frecuentes
- ModuleNotFoundError solo con el programador de tareas. La tarea ejecuta otro Python. Haz que la tarea apunte al
python.exedel venv. - Rutas relativas. Son relativas a la carpeta Start in (Iniciar en) de la tarea, no a la del script. Construye las rutas a partir de
pathlib.Path(__file__).parent. - SSL: CERTIFICATE_VERIFY_FAILED. Un proxy corporativo que inspecciona HTTPS usa su propio certificado; pídeselo a TI, o ejecuta el script con el Python que proporciona tu equipo de TI.
- Unidades de red. Una tarea que se ejecuta mientras no has iniciado sesión no ve las letras de unidades asignadas; usa rutas UNC.
Casos de uso: Recibe una alerta cuando un cron job o un script programado de Python falla · Recibe una alerta cuando falla un trabajo de producción de SPSS Statistics · Monitorea un agente de IA o un job de LLM programados · Recibe una alerta cuando un job de IA devuelve una respuesta vacía o demasiado corta · Recibe una alerta cuando un job carga 0 filas o muchas menos de lo habitual · Comprueba que una tabla o un archivo diario esté actualizado · Comprueba que la copia de seguridad de anoche exista y no esté vacía. Más preguntas: preguntas frecuentes.