Cron Jobs
Os Cron Jobs são tarefas HTTP agendadas que o Dashboard.PT chama por ti segundo um horário. Em vez de correres um daemon cron no teu próprio servidor, registas um URL e um intervalo, e o Dashboard.PT dispara-o de forma fiável, repete em caso de falha, guarda um histórico completo e avisa-te se algo se partir.
Visão geral
Um cronjob é um URL que o Dashboard.PT pede nos horários que definires. É ideal para desencadear trabalho recorrente, como aquecimento de cache, geração de relatórios, scripts de limpeza, sincronização de dados ou qualquer endpoint que precise de correr com regularidade. Como o agendamento vive no Dashboard.PT, continua a correr mesmo que a tua máquina esteja desligada.
Funcionalidades principais
- Agenda qualquer endpoint HTTP sem manter um daemon cron
- Pedidos HEAD, GET ou POST com um código de estado esperado
- Repetições automáticas para ultrapassar falhas passageiras
- Templates de cron reutilizáveis para configurações comuns
- Histórico de execução completo com estado, duração e resposta
- Alertas de falha por email, SMS e/ou webhook, mais o centro de notificações
- Activa ou desactiva um cronjob a qualquer momento
Criar um cronjob
Abre a secção Cron Jobs e selecciona Novo cronjob. Configura os campos seguintes e guarda:
- URL: o endpoint a chamar, incluindo
https://ouhttp://. - Horário / intervalo: com que frequência a tarefa corre — um intervalo simples (por exemplo a cada 15 minutos ou uma vez por dia) ou uma hora específica.
- Método HTTP: HEAD, GET ou POST, consoante o que o teu endpoint espera.
- Código de estado esperado: o código HTTP que significa que a execução teve sucesso, normalmente
200. Qualquer outro valor conta como falha. - Repetições: quantas tentativas extra fazer se o primeiro pedido falhar, antes de a execução ser declarada falhada.
- Timeout: quantos segundos esperar por uma resposta antes de a tentativa ser tratada como falhada.
- Notificações: escolhe email, SMS e/ou webhook para seres avisado quando uma tarefa falhar depois das repetições.
Nota: mantém cada tarefa disparada rápida e idempotente. Se uma tarefa pode correr mais do que uma vez em segurança, as repetições nunca causam efeitos secundários.
Templates de cron
Se crias muitas tarefas parecidas, os templates de cron permitem reutilizar uma configuração comum em vez de preencher cada campo à mão. Guarda um conjunto de opções — método, estado esperado, repetições, timeout e horário — como template e aplica-o ao criar novos cronjobs.
- Uniformiza as definições num grupo de tarefas relacionadas.
- Cria novas tarefas em segundos, partindo de um template.
- Reduz erros ao reutilizar configurações que já testaste.
Histórico de execução e registos
Sempre que um cronjob corre, o Dashboard.PT regista o resultado para veres exactamente o que aconteceu. Abre um cronjob para rever o seu histórico de execução, onde cada execução mostra:
- Estado: se a execução teve sucesso ou falhou.
- Duração: quanto tempo o pedido demorou a concluir.
- Resposta: o código de estado devolvido e os detalhes da resposta.
O histórico facilita a deteção de padrões — uma tarefa que está a ficar mais lenta, um endpoint que falha a uma certa hora do dia, ou uma execução que devolveu um código inesperado.
Notificações de falha
Quando um cronjob falha depois de esgotar as repetições configuradas, o Dashboard.PT notifica-te para que uma tarefa avariada nunca passe despercebida. Podes ser avisado por:
- Email — uma mensagem com os detalhes da execução falhada.
- SMS — um texto curto para tarefas que consideres críticas (sujeito ao plano e ao crédito de SMS).
- Webhook — um POST para os teus próprios sistemas ou um serviço como o Slack ou o Teams.
Todas as falhas aparecem também no centro de notificações da aplicação (o ícone do sino no cabeçalho). Nessa notificação, o Recurso mostra o nome do cronjob, para saberes de relance qual a tarefa que falhou.
Nota: a notificação só é enviada depois de todas as repetições estarem gastas, por isso uma única tentativa instável que depois tem sucesso não te vai alertar.
Activar e desactivar um cronjob
Podes activar ou desactivar qualquer cronjob a qualquer momento. Uma tarefa desactivada mantém-se totalmente configurada mas não é disparada nem gera notificações — útil durante janelas de manutenção, enquanto um endpoint está a ser reconstruído, ou para pausar uma tarefa sem a apagar. Volta a activá-la quando estiveres pronto e o agendamento retoma.
Referência dos campos do cronjob
A tabela abaixo resume todos os campos que podes configurar num cronjob.
| Campo | Descrição |
|---|---|
| URL | O endpoint que o Dashboard.PT chama, incluindo o protocolo. |
| Horário / intervalo | Com que frequência a tarefa corre, ou a hora a que corre. |
| Método HTTP | HEAD, GET ou POST. |
| Código de estado esperado | O código HTTP que conta como execução bem-sucedida (por exemplo 200). |
| Repetições | Tentativas extra antes de a execução ser declarada falhada. |
| Timeout | Segundos a esperar por uma resposta antes de a tentativa falhar. |
| Notificações | Alertas por email, SMS e/ou webhook quando a tarefa falha depois das repetições. |
| Activo | Se a tarefa está actualmente agendada ou em pausa. |
Dica: define umas duas repetições para evitar alertas por falhas passageiras. Um breve soluço de rede ou um 5xx momentâneo costumam resolver-se na tentativa seguinte, por isso um número pequeno de repetições mantém a tua caixa de entrada sem ruído e continua a apanhar falhas reais e prolongadas.
Quer experimentar? O plano gratuito não tem limite de tempo.
Criar conta gratuita