Qué se puede informar
Además de “se ejecutó”, un script puede enviar números. TaskBeacon los compara con reglas que puedes cambiar en la página del job (Alert me when, avísame cuando).
Cuando termina y cuando empieza
El ping when it ends (cuando termina) siempre está en el código de la pestaña Code (código): le dice a TaskBeacon que el job se ejecutó, y si no llega a tiempo el job cuenta como Missed (no ejecutado).
El ping when it starts (cuando empieza, /start) está activado por defecto: mide cuánto dura cada ejecución y convierte una ejecución que se queda colgada en Late (retrasada).
Desmárcalo en la pestaña Code si solo quieres el final.
Número de filas
?rows=15234. La primera vez que un job envía filas, recibe dos reglas: alertar cuando las filas bajan más de un 40 % por debajo del promedio reciente, o son menos de 1. Un job que no envía números no tiene reglas.
Fecha más reciente
?last_date=2026-11-05, la fecha más reciente de tus datos. En la página del job, en Alert me when, añade una regla: nombre last_date, Is a date older than X days (es una fecha de hace más de X días). Una fecha más antigua envía una alerta Odd data (datos raros).
Tamaño de la copia de seguridad
?bytes=…, el tamaño de un archivo de copia de seguridad. Alerta cuando está vacío o es mucho más pequeño de lo habitual. Envía el ping después de la copia, no después del volcado.
Tu propio número
Cualquier nombre y valor, por ejemplo ?total_sales=81234.5. Añade una regla para él en la página del job, en Alert me when: su nombre, Is below X (es menor que X), Is above X (es mayor que X) o Drops more than X% (baja más de un X %), y X.
Código de salida
Pon el código de salida al final de la dirección: /ping/<id>/0 es una ejecución terminada, cualquier otro número
(/ping/<id>/1) un fallo con ese código de salida, igual que /fail?exit_code=1. Un shell puede enviarlo
tal cual, sin un if:
/path/to/your-job.sh
curl -fsS -m 10 "https://taskbeacon.io/ping/<id>/$?"
El código de PowerShell, Batch y cron de la pestaña Code funciona así: /$code, /%TB_RC% y /$?.
Palabras en la salida
Algunos programas terminan con el código de salida 0 incluso cuando han mostrado un error. Envía la salida (o sus últimas líneas) como cuerpo del
ping final y añade una regla de salida en la página del job, en Alert me when: elige
Fail if the output contains (fallar si la salida contiene) u OK only if the output contains (OK solo si la salida contiene) y escribe las palabras en X, separadas por comas, por ejemplo
ERROR, Traceback. No distingue mayúsculas de minúsculas.
- Fail if the output contains: una ejecución cuya salida contiene alguna de las palabras cuenta como Failed (fallida), con el motivo Output contains 'ERROR'.
- OK only if the output contains: una ejecución cuya salida no contiene ninguna de las palabras cuenta como Failed (también cuando no envió ninguna salida).
/path/to/your-job.sh > job.log 2>&1
tail -n 20 job.log | curl -fsS -m 10 --data-binary @- "https://taskbeacon.io/ping/<id>/$?"
Las reglas revisan el ping final (la dirección sin más, o el código de salida 0): su cuerpo de texto, un campo log en un cuerpo JSON
o ?log=. Un /fail es un fallo de todos modos. El código de PowerShell y Batch de la pestaña Code envía sus últimas líneas solo cuando hay un fallo, así que, para una regla de salida, envía tú mismo la salida con el ping final, como arriba.
En la pestaña Code, marca lo que quieres informar y el código cambia en consecuencia. TaskBeacon recibe solo lo que envían las líneas: estos números y, cuando hay un fallo, las últimas 20 líneas de la salida (o el mensaje de error). Desmarca Send output lines (enviar líneas de salida) para enviar solo el mensaje de error o el código de salida (consulta la política de privacidad, en inglés). Tus datos se quedan en tu equipo.
Casos de uso: Recibe una alerta cuando un do-file de Stata falla en modo batch · Task Scheduler Last Run Result 0x0, pero el script falló · Errores de scripts de PowerShell y el código de salida en Task Scheduler · Entérate cuando falla un script de R programado · Recibe una alerta cuando un job batch de SAS termina con errores · Monitorea un agente de IA o un job de LLM programados · Pregunta a Claude o ChatGPT qué falló anoche · 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.