Cron e tarefas agendadas

No instante em que uma tarefa cron falha.

O Pocket Alert envia uma notificação push ao seu celular no momento em que uma tarefa cron falha. Encadeie uma linha em qualquer comando agendado com && ou || — dispare em caso de falha, de sucesso ou nos dois, e o push chega assim que a tarefa encerra, com a saída de erro incluída.

Dispara pelo código de saídaUma linha · sem daemoncron · systemd · K8sAtualizado em
Recursos

Nunca mais perca uma tarefa que falhou

Uma importação que falhou deve chegar até você na hora, horas antes de você abrir os logs.

Uma linha no crontab

Encadeie um push em qualquer linha do cron com && ou ||. É uma única chamada curl, sem daemon para monitorar.

Alerta só em caso de falha

Com ||, o alerta dispara apenas quando o comando encerra com código diferente de zero.

Inclua o erro

Envie o stderr ou o código de saída para a mensagem, para que o push chegue com o erro já anexado.

Qualquer agendador

crontab, timers do systemd, o agendador do Laravel, Sidekiq e CronJobs do K8s funcionam, porque todos executam comandos.

Heartbeat em caso de sucesso

Envie um heartbeat após uma execução bem-sucedida. Quando ele deixar de chegar, você saberá que a tarefa morreu em silêncio e poderá investigar.

Instantâneo ao terminar

O push chega no momento em que a tarefa encerra, horas antes de alguém acompanhar os logs.

Primeiros passos

Três passos para alertas de falha no cron

1

Pegue sua URL ou CLI

Copie a URL de webhook de entrada do seu aplicativo ou instale a CLI do Pocket Alert.

2

Adicione uma linha

Encadeie uma chamada curl ou pocketalert send na sua linha do cron, com || para falhas ou && para sucesso.

3

Receba o alerta

Execute a tarefa. Se ela falhar, seu celular vibra com o título e a saída de erro que você definiu.

Conecte um alerta à sua tarefa cron

Instale e autentique a CLI

sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY

Alerte somente quando a tarefa falhar

Encadeie o alerta com || para que ele dispare apenas com código de saída diferente de zero:

0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
  -t "Cron failed: mybackup" -m "Exited non-zero at $(date)"

Inclua a saída de erro

0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
  -t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"

Heartbeat em caso de sucesso

Adicione um ping com && após uma execução limpa. Quando ele deixar de chegar, a tarefa morreu em silêncio:

0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"

Sem CLI? Chame a API com curl

0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'

A documentação cobre a segmentação e os canais por aplicativo.

FAQ

Dúvidas respondidas

Encadeie uma notificação ao seu comando cron no shell. `&&` dispara após uma execução bem-sucedida, `||` dispara após uma falha, e o Pocket Alert envia a notificação push quando a tarefa encerra.

Use `||` para que o alerta dispare apenas quando o comando encerrar com código diferente de zero: `mybackup.sh || curl ...`. Tarefas quebradas chegam até você, e o resto fica em silêncio.

Sim. Capture o código de saída ou a saída e insira no corpo da mensagem. A CLI do Pocket Alert envia o stderr diretamente para a notificação.

Qualquer agendador funciona: crontab, timers do systemd, o agendador do Laravel, cron do Rails ou Sidekiq, Agendador de Tarefas do Windows, CronJobs do Kubernetes. Se ele executa um comando, você pode encadear um alerta nele.

Envie um ping de conclusão com `&&` após cada execução bem-sucedida. Quando o ping deixar de chegar, você saberá que a tarefa parou de rodar, sem precisar de ferramentas extras.

Adicione level=critical ao alerta de falha e ele atravessa o modo Não perturbe no Android e o Foco no iPhone. Para pings de heartbeat, use level=silent: eles aparecem no histórico sem som, então o registro existe, mas o celular continua quieto.

Pegue a tarefa cron que quebrou em silêncio.

Adicione uma linha ao seu crontab e uma tarefa que falhar chega ao seu celular assim que encerrar.