Stata
Usa curl mediante shell: curl.exe en Windows 10 y 11, curl en macOS y Linux (el código elige uno con c(os), así que el mismo do-file funciona en todas partes). Stata en modo batch siempre sale con 0, así que el error se captura dentro del do-file y se envía con el código r() de Stata. Pon en tb_log el log del do-file (stata -b do job.do escribe job.log) y sus últimas 20 líneas van con el fallo.
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 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'"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 código de retorno de Stata y, si tb_log está definido, las últimas 20 líneas del log.
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 do-file según un horario
Stata para Windows ejecuta un do-file sin ventana con la opción /e (con /b espera a que hagas clic en OK, cosa que un horario no puede hacer). Usa la ruta completa de tu edición de Stata:
"C:\Program Files\Stata18\StataMP-64.exe" /e do "C:\jobs\sales.do"
Para iniciarlo todas las mañanas, crea una tarea desde un Símbolo del sistema (una línea):
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "\"C:\Program Files\Stata18\StataMP-64.exe\" /e do \"C:\jobs\sales.do\""
En macOS o Linux, ejecútalo en modo batch desde cron (crontab -e; el nombre del programa depende de tu edición, p. ej. stata-mp):
0 6 * * * cd /home/me/jobs && /usr/local/stata/stata-mp -b do sales.do
El código de arriba usa curl.exe en Windows y curl en los demás sistemas (comprueba c(os)), así que el mismo do-file funciona en cualquier máquina.
Stata escribe sales.log en su carpeta de trabajo. En Task Scheduler pon en Start in (Iniciar en) la carpeta del do-file (editar la tarea → Actions → Start in); si no, el log puede acabar en la carpeta del programa Stata, donde normalmente no puedes escribir (Stata se detiene entonces con r(608)).
Por qué el código de salida miente
Cuando un do-file se detiene por un error en modo batch, el error está en el log, pero Stata no se lo comunica a Windows como un fallo: Task Scheduler sigue mostrando The operation completed successfully (0x0).
Por eso el código de arriba envuelve tu job en capture noisily { … }: el do-file captura su propio error, envía /fail?rc= con el código de retorno de Stata (por ejemplo rc=601, archivo no encontrado) y luego se detiene con exit.
Pon dentro de las llaves todo lo que pueda fallar. Un comando que falla después de la llave de cierre no se captura.
Reportar el número de filas
La última línea envía _N, el número de observaciones en memoria cuando termina el do-file. Si el conjunto de datos que te interesa no es el que está en memoria al final, cuéntalo donde está:
use "C:\data\sales_clean.dta", clear
local tb_rows = _N
TaskBeacon avisa cuando las filas caen más de un 40% por debajo de las ejecuciones recientes o son 0. Puedes cambiar ambas reglas en la página del job.
Problemas frecuentes
- No llega ningún ping.
shellejecutacurl.exeen Windows (incluido en Windows 10 y 11) ocurlen macOS y Linux. Ejecuta la línea de curl en un Símbolo del sistema o una terminal de esa máquina; ahí se ve si un proxy o un firewall bloquea HTTPS. - Parpadea una ventana negra (Windows). Es
shellabriendo una consola para curl; es inofensivo. - Llega el inicio, pero nunca el final. El do-file se detuvo fuera de
capture noisily, o Stata fue terminado a la fuerza. Pasado el margen, el job aparece como Late (retrasado). - Unidades de red. Una tarea que se ejecuta mientras no has iniciado sesión no ve letras de unidades asignadas como
S:; usa rutas UNC (\\server\share\…).
Casos de uso: Recibe una alerta cuando un do-file de Stata falla en modo batch. Más preguntas: preguntas frecuentes.