Como descobrir por que uma tarefa agendada (cron job) falhou
Oi! Aqui é a Sensei da GeHost 🥋 Se você configurou uma tarefa automática no seu site (tipo aquele script que roda todo dia de madrugada, um backup, uma rotina do seu sistema) e ela simplesmente "não rodou" ou rodou errado, este guia vai te ensinar, passo a passo, a encontrar as pistas de onde ela travou. Vamos com calma, sem termo técnico chato.
O que é um "cron job", afinal?
Cron job é só o nome técnico pra uma tarefa que roda sozinha, em horários programados, sem você precisar clicar em nada. Ela mora dentro do seu cPanel, na seção de ferramentas avançadas.
Passo 1 — Entre no seu cPanel
- Acesse o painel de administração do seu site (o endereço e os dados de acesso ficam no seu painel do cliente, em Serviços).
- Faça login com o usuário e senha do cPanel.
Passo 2 — Encontre a área de "Cron Jobs"
Já dentro do cPanel, procure (geralmente na seção "Avançado") a ferramenta chamada Cron Jobs. Lá você vai ver a listinha das tarefas que estão programadas, com o horário e o comando de cada uma.
💡 Dica da Sensei: se você não lembra qual comando/script foi cadastrado, é aqui que você confere — copie o comando exato pra conseguir investigar melhor.
Passo 3 — Veja se o erro chegou por e-mail
Por padrão, quando um cron job roda, o resultado (inclusive erros) costuma ser enviado para o e-mail cadastrado na configuração da tarefa. Esse é o primeiro lugar mais fácil de olhar:
- Confira a caixa de entrada (e a pasta de spam!) do e-mail associado ao cron job.
- A mensagem normalmente traz a saída do comando — se deu erro de permissão, comando não encontrado, script com bug, etc., costuma aparecer ali.
Passo 4 — Se a tarefa grava um arquivo de log, confira pelo Gerenciador de Arquivos
Muita gente configura o próprio comando do cron pra "salvar" o resultado num arquivo de log (é uma boa prática!). Se for o seu caso, você consegue abrir esse arquivo direto pelo cPanel:
- Volte à tela inicial do cPanel e abra o Gerenciador de Arquivos.
- Navegue até a pasta onde o script/log foi configurado para salvar (normalmente dentro da sua pasta principal do site ou uma pasta específica de logs, conforme o comando cadastrado).
- Clique com o botão direito no arquivo de log e escolha "Editar" ou "Ver" para ler o conteúdo — normalmente ele mostra a última execução no final do arquivo.
💡 Dica da Sensei: se o cron job não estiver configurado para gravar em arquivo, vale a pena editar o comando dele e adicionar isso — assim, da próxima vez, fica bem mais fácil de investigar. Se não se sentir seguro pra mexer no comando, nosso suporte te ajuda com isso.
Passo 5 — Erros mais comuns que costumam aparecer
- Caminho do script errado: o comando aponta para um arquivo que foi movido, renomeado ou apagado.
- Permissão de arquivo: o script não tem permissão para ser executado ou para gravar em alguma pasta.
- Erro dentro do próprio script/sistema: um bug no código, uma dependência que faltou, um banco de dados fora do ar no momento da execução.
- Horário mal configurado: às vezes a tarefa nem chegou a rodar no horário esperado por engano na configuração do próprio cron.
Ainda não achou o motivo? A gente te ajuda
Se você seguiu os passos acima e não conseguiu identificar o problema (ou se mexer em código/arquivo do sistema te deixa insegura(o) — e tudo bem, ninguém nasceu sabendo!), é só abrir um chamado com a nossa equipe pelo painel.gehost.com.br. Conte qual é a tarefa, o horário esperado e, se tiver, cole o trecho do e-mail de erro ou do log — isso já adianta bastante a investigação do nosso time.
🥋 Lembrete da Sensei: nunca apague nem recrie a tarefa cron "no susto" tentando consertar — isso pode te fazer perder a configuração original. Prefira investigar com calma ou chamar a gente, combinado?