Tarefas agendadas do Admin: histórico de execuções cron

Confira se uma tarefa em segundo plano rodou, quanto demorou e se falhou: filtre o histórico de execuções cron da sua organização por tarefa, status e data em Admin → Tarefas agendadas.

Parte do trabalho no Docklify acontece em segundo plano, num horário marcado: ninguém clica num botão, a tarefa simplesmente roda quando chega a hora. Admin → Tarefas agendadas é onde você confere essas execuções depois: cada execução deixa uma linha com quando começou, quanto demorou, se deu certo ou falhou, um breve resumo do que fez e a mensagem de erro, se falhou. A página mostra apenas as execuções da sua própria organização. Apenas os papéis Owner e Admin podem abri-la.

Passo 1: Abra o histórico e leia uma linha#

1. Abra Admin → Tarefas agendadas (/admin/cron-runs). A lista de execuções carrega sozinha: aqui não há nada para iniciar nem configurar.
2. Escolha qualquer linha e leia da esquerda para a direita: hora de início, nome da tarefa, duração, status, resumo, erro.
3. Se a lista for longa, use a paginação no rodapé da tabela para percorrê-la: a página mostra 50 execuções por vez, por padrão.

• Início é o momento em que aquela execução começou, mostrado até o segundo: use-o para relacionar uma execução com a hora em que algo devia acontecer.
• Tarefa é o nome da tarefa agendada, mostrado exatamente como o sistema a chama.
• Resumo é uma breve lista do que a execução produziu: contagens e resultados em forma simples de chave e valor. Resumos longos são cortados na tabela, então trate a linha como a manchete, não como o relatório completo.
• Erro fica vazio (um traço) nas execuções que não falharam. Numa execução que falhou, mostra a mensagem de erro, cortada na tabela: passe o cursor por cima para ler o texto completo.

Uma linha é uma execução, não uma tarefa. A mesma tarefa aparece de novo cada vez que roda, então uma tarefa saudável acumula uma longa série de linhas com os dias. Ao percorrer a tabela em Admin → Tarefas agendadas, você está lendo essa série: as linhas perto do momento que importa, na ordem que a tabela dá depois de filtrar.

Passo 2: Filtre por tarefa, status e data#

1. No cartão de filtros acima da tabela, escolha uma Tarefa, ou deixe em Todos para ver todas as tarefas juntas.
2. Escolha um Status se só se importa com um tipo de resultado: por exemplo Falhou, para ver só as execuções que deram errado.
3. Defina uma data De e Até para reduzir a lista a um período: uma noite, uma semana, quando o problema foi percebido.
4. Clique em Buscar. A lista recarrega da primeira página com os seus filtros aplicados.

O seletor de tarefas em Admin → Tarefas agendadas lista as tarefas agendadas que relatam execuções para a sua organização: employee-term-sweep, abc-analysis e sequence-runner. Escolher uma é a forma mais rápida de responder «esta tarefa específica tem rodado ultimamente?»: se as linhas dela continuam aparecendo no horário e com Sucesso, sim.

Passo 3: Leia o status e a duração#

• success (verde): a execução terminou e fez o seu trabalho.
• failed (vermelho): a execução parou com um erro. Leia a coluna Erro da mesma linha antes de fazer qualquer outra coisa.
• running (amarelo): a execução começou e ainda não terminou. Confira de novo daqui a pouco; uma execução terminada vira success ou failed.
• Duração é mostrada em segundos, ou em minutos e segundos nas execuções mais longas (por exemplo 2m5s). Um traço significa que a execução ainda não tem duração registrada: típico enquanto ela ainda está rodando.

Leia status e duração juntos. Um success que de repente demora dez vezes mais que suas execuções habituais merece ser anotado mesmo tendo passado, e um failed com duração muito curta costuma ter parado no início: o texto de erro daquela mesma linha dirá onde. Comparar uma execução com as linhas anteriores da mesma tarefa em Admin → Tarefas agendadas é a forma mais rápida de detectar os dois padrões.

Passo 4: Verifique uma tarefa que você suspeita que não rodou#

1. Filtre por aquela tarefa e ponha o período de datas em quando ela devia ter rodado, depois clique em Buscar.
2. Se não houver nenhuma linha naquele período, nenhuma execução foi registrada para aquele momento: a tarefa não rodou, ou rodou mas não relatou.
3. Uma linha com failed significa que ela rodou e encontrou um problema: copie o nome da tarefa, a hora de início e o texto completo do erro (passe o cursor para ver tudo): esse trio é o que o suporte vai pedir.
4. Uma linha que continua em running muito depois de começar merece uma segunda olhada mais tarde: repita a busca e veja se ela virou success ou failed.

Recursos do Docklify usados neste artigo#

• Histórico de execuções cron da sua organização (início / tarefa / duração / status / resumo / erro) — Admin → Tarefas agendadas (/admin/cron-runs)
• Filtros de execuções por tarefa, status e período de datas, com Buscar — Admin → Tarefas agendadas (/admin/cron-runs)
• Leitura do status de relance (running / success / failed, por cores) — Admin → Tarefas agendadas (/admin/cron-runs)
• Texto completo do erro em execuções com falha (passe o cursor sobre a célula Erro) — Admin → Tarefas agendadas (/admin/cron-runs)