Recibe una alerta cuando un job carga 0 filas o muchas menos de lo habitual
La importación nocturna terminó, el programador de tareas dice que fue un éxito y la tabla tiene 0 filas. O 2140 filas en lugar de las 48 000 habituales. Nada falló, así que nada avisó. Los códigos de salida no pueden detectar esto; un conteo de filas enviado en cada ejecución sí.
Por qué “éxito” no dice nada sobre las filas
Un programador de tareas juzga un job por su código de salida, y el código de salida de un script solo dice si se cayó. Todos estos terminan con 0:
- el archivo de origen llegó vacío, o era otra vez el archivo de ayer;
- el filtro de fecha de una consulta no encontró nada por una zona horaria o un día festivo;
- una API respondió con una lista vacía en lugar de un error;
- un join o un filtro del script descartó la mayoría de las filas después de que se renombrara una columna en el origen;
- una exportación se ejecutó contra una base de datos de prueba que quedó en la cadena de conexión.
El job hizo exactamente lo que se le pidió. A los desarrolladores les pasa lo mismo (“Your job succeeded but did nothing – how do you even catch that?” en Reddit, 2025), y la respuesta siempre es la misma: el job tiene que reportar lo que hizo, y algo tiene que compararlo con lo que suele hacer.
Envía el conteo de filas en cada ejecución
En TaskBeacon, el ping de fin lleva el número: ?rows=48210, o JSON. La primera vez que un job lo envía, el job recibe dos reglas para él, que puedes cambiar en la página del job:
- Rows below 1 (filas por debajo de 1): una ejecución que no cargó nada pasa a Odd data (datos raros) de inmediato.
- Rows drop more than 40% below the recent average (las filas caen más de un 40 % por debajo del promedio reciente): comparado con las últimas ejecuciones normales, en cuanto hay 3. Las ejecuciones que rompieron una regla no cuentan para el promedio, así que una mala noche no se convierte en la nueva normalidad.
En Python, el código predeterminado ya envía len(df):
# --- 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.
Cuenta lo que importa: las filas escritas en la tabla de destino, no las filas leídas. Si cargas varias tablas, envía varios números ({"rows": 48210, "orders": 1830}) y añade una regla para cada uno (las reglas sobre tus propios números son parte de Pro, abiertas a todos por ahora; las reglas de filas están en todos los planes); consulta tu propio número. Lo mismo funciona en R (nrow(df)), Stata (_N), SAS y SPSS, cuyo código predeterminado también envía un conteo.
Cómo se ve la alerta
El job pasa a Odd data y la alerta dice el motivo en una línea, por ejemplo rows = 2,140, 96% below the recent average of 48,215. La página del job muestra las filas de cada ejecución frente al nivel habitual, así que puedes ver si fue una mala noche o un descenso lento. Si un número menor es la nueva normalidad, cambia la regla o marca la ejecución como revisada.
Sin TaskBeacon
Pon la comprobación dentro del job: después de cargar, cuenta las filas y lanza un error (termina con un código distinto de cero) cuando el conteo sea 0 o esté por debajo de un mínimo fijo, para que el fallo sea visible para el programador de tareas. En un proyecto de dbt, un data test sobre el modelo hace esto; Great Expectations tiene expect_table_row_count_to_be_between. Un mínimo fijo es fácil; “mucho menos de lo habitual” requiere el historial de los conteos anteriores, lo que significa guardarlos en algún lugar y calcular un promedio, y aun así necesitas una forma de que te avisen. Relacionado: las comprobaciones de frescura de datos detectan el caso en que las filas están, pero son viejas.
¿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: Número de filas · Estados · Python.
- Comprueba que una tabla o un archivo diario esté actualizadoUna carga que “funciona” pero vuelve a traer los datos de ayer.
- Comprueba que la copia de seguridad de anoche exista y no esté vacíaLa copia de seguridad se ejecutó; el archivo que generó pesa 0 KB.
- Recibe una alerta cuando un do-file de Stata falla en modo batchStata /e y -b no informan al programador de un do-file fallido.
- Alertas de fallo de jobs de SQL Server Agent sin Database MailLos correos de Agent necesitan Database Mail, un operador y un reinicio, y no dicen nada de una tarea que no se ejecutó.
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
- Great Expectations: expect_table_row_count_to_be_between (sin fecha, © 2026; revisado el 9 de noviembre de 2026)
- dbt docs: data tests (sin fecha; revisado el 9 de noviembre de 2026)
- Reddit r/laravel: Your job "succeeded" but did nothing – how do you even catch that? (hacia 2025 (estimado))
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.