Recibe una alerta cuando un do-file de Stata falla en modo batch
Ejecutas un do-file cada noche en el modo batch de Stata, se detiene por un error, y Task Scheduler sigue diciendo The operation completed successfully (0x0). Nadie se entera hasta que alguien abre el informe. El modo batch de Stata oculta el error al programador de tareas, pero el propio do-file puede informar de él, con el código r() de Stata.
Por qué el programador cree que funcionó
En Windows, Stata ejecuta un do-file sin ventana con StataMP-64.exe /e do job.do (/b también funciona, pero al final espera a que hagas clic en OK, algo que un horario no puede hacer). En Linux y macOS el equivalente es stata -b do job.do. En ambos casos Stata escribe la salida en job.log, y cuando el do-file se detiene por un error, el error está en ese log: una línea como r(601);.
El proceso en sí, sin embargo, termina con normalidad. Los usuarios de Stata llevan años informando, en Windows, Linux y macOS, de que el modo batch devuelve el código de salida 0 tras un error (nosotros vimos lo mismo en Stata 17 MP para Windows con /e), y las preguntas frecuentes de StataCorp sobre el modo batch no dicen nada de los códigos de salida. Un programador de tareas solo puede juzgar un job por su código de salida, así que Task Scheduler muestra 0x0 y cron ve un éxito. La solución habitual es buscar r( en el log después, lo que funciona hasta que el log acaba en una carpeta que no esperabas.
Otras dos formas en que un job de Stata se queda en silencio: la tarea nunca arranca (el PC estaba apagado o suspendido, o la cuenta de la tarea no puede iniciar sesión), y Stata se queda esperando en un cuadro de diálogo en lugar de terminar, algo que algunos usuarios han visto incluso en modo batch. Ninguna de las dos produce una línea de log en la que te fijarías.
Informa del error desde dentro del do-file
La solución es dejar que el do-file capture su propio error y lo notifique, en lugar de confiar en el código de salida. El código de abajo envuelve tu job en capture noisily { … }. Si algo falla dentro, envía /fail con el código de retorno (por ejemplo rc=601, archivo no encontrado) y, si defines tb_log como el log del do-file, sus últimas 20 líneas. Después se detiene con el mismo error. En Windows, Stata sigue terminando con 0 en modo batch (ejecutamos este código en Stata 17 MP con /e: los pings llegaron, y Windows vio el código de salida 0 tras r(601)), así que lo que te avisa es la alerta, no Task Scheduler. Cuando el do-file termina bien, envía el número de observaciones en memoria.
* --- TaskBeacon: top of the do-file ---
local tb "https://taskbeacon.io/ping/your-job-id"
* curl.exe is built into Windows 10 and 11; macOS and Linux have curl
local tb_curl = cond(c(os) == "Windows", "curl.exe", "curl")
local tb_log "" // optional: this do-file's log (batch mode: stata -b do job.do, or StataMP-64.exe /e do job.do on Windows, writes job.log in the current folder); its last 20 lines go with a failure
shell `tb_curl' -fsS -m 10 "`tb'/start"
capture noisily {
* --- your code here (the example data: replace with your own) ---
sysuse auto, clear
}
quietly {
local tb_rc = _rc
if `tb_rc' {
* the last 20 lines of the log (if tb_log is set) go with the failure
local tb_data ""
if `"`tb_log'"' != "" {
tempfile tb_tail
tempname tb_in tb_out
capture {
file open `tb_in' using `"`tb_log'"', read text
local tb_n 0
file read `tb_in' tb_line
while r(eof) == 0 {
local tb_n = `tb_n' + 1
local tb_k = mod(`tb_n', 20)
local tb_l`tb_k' = substr(`"`macval(tb_line)'"', 1, 300)
file read `tb_in' tb_line
}
file close `tb_in'
file open `tb_out' using `"`tb_tail'"', write text replace
forvalues tb_i = `=max(1, `tb_n' - 19)'/`tb_n' {
local tb_k = mod(`tb_i', 20)
file write `tb_out' `"`macval(tb_l`tb_k')'"' _n
}
file close `tb_out'
local tb_data `"--data-binary "@`tb_tail'" -H "Content-Type: text/plain""'
}
capture file close `tb_in'
capture file close `tb_out'
}
shell `tb_curl' -fsS -m 10 `tb_data' "`tb'/fail?rc=`tb_rc'"
exit `tb_rc'
}
}
* --- TaskBeacon: end of the do-file ---
local tb_rows = _N
shell `tb_curl' -fsS -m 10 "`tb'?rows=`tb_rows'"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.
Pon todo lo que pueda fallar entre las llaves: un comando después de la llave de cierre no se captura. Los pings usan curl.exe, que forma parte de Windows 10 y 11, y esperan como máximo 10 segundos, así que un problema de red nunca detiene tu do-file. El código está escrito para Stata en Windows; en Linux o macOS, escribe curl en lugar de curl.exe.
Qué obtienes
- Failed (fallido), de inmediato, con el código
r()y el final del log en la alerta. Verr(601)y el nombre del archivo en tu bandeja de entrada suele bastar para saber qué arreglar. - Missed (no ejecutado) cuando el do-file no informó antes de su hora prevista más un margen, por ejemplo porque el PC estaba apagado. El horario lo defines en el job, como en Task Scheduler.
- Late (retrasado) cuando llegó el ping de inicio pero la ejecución está tardando mucho más de lo habitual, que es el aspecto de un do-file atascado en un cuadro de diálogo.
- Odd data (datos raros) cuando terminó pero
_Ncayó más de un 40% por debajo de las ejecuciones recientes, o es 0. Consulta 0 filas o muchas menos de lo habitual.
Para programar el do-file, configura la carpeta Start in (iniciar en) de la tarea como la carpeta del do-file, para que el log se escriba donde puedas encontrarlo (si no, Stata puede intentar usar su carpeta de programa y detenerse con r(608)). La página de Stata en la documentación tiene la línea schtasks completa.
Sin TaskBeacon
Puedes hacer que el código de salida diga la verdad tú mismo: inicia Stata desde un pequeño .bat o script de shell y, cuando Stata termine, busca en el log una línea que empiece por r( seguido de dígitos; si encuentras una, termina con 1. Task Scheduler muestra entonces 0x1. Eso cubre los errores, pero no una ejecución que nunca arrancó ni una sesión de Stata esperando en un cuadro de diálogo, y aún tienes que mirar Task Scheduler para ver el 0x1. Para un correo también necesitas algo que lo envíe, cosa que Task Scheduler ya no hace por sí solo (consulta correo cuando falla una tarea programada).
¿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: Stata · Estados · Qué se puede reportar.
- Task Scheduler Last Run Result 0x0, pero el script fallóLast Run Result 0x0 solo significa que el programa que inició devolvió 0.
- 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.
- Descubre cuándo un job programado no se ejecutó en absolutoUna ejecución que nunca ocurrió no deja ningún error del que avisar.
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
- StataCorp FAQ: Running Stata for Windows in batch mode (/e y /b) (sin fecha, los ejemplos usan Stata 15; revisado el 9 de noviembre de 2026)
- StataCorp FAQ: Running Stata in batch mode on Unix (-b escribe file.log) (sin fecha; revisado el 9 de noviembre de 2026)
- Archivo de Statalist: un archivo batch devuelve 0 aunque el do-file falló (Windows /e) (2008, antiguo: señal de una pregunta de hace años)
- Archivo de Statalist: ningún código de salida distinto de cero tras un error en modo batch (macOS) (2011, antiguo: señal de una pregunta de hace años)
- Statalist: Stata batch mode exit status on error (Época de Stata 13, hacia 2014; antiguo)
- Un wrapper que busca r(…); en el log y sale con 1 (P. Schumm, gist de GitHub) (sin fecha)
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.