Agendamentos
Um agendamento dispara o agente em horários definidos, sem ninguém presente.
Criar
| Campo | O que define |
|---|---|
| Horário | Quando disparar |
| Fuso horário | O fuso em que o horário é lido |
| Dados de entrada | O que o agente recebe em cada disparo |
| Se a execução anterior ainda estiver rodando | Ver política de concorrência |
| Se um horário for perdido | Ver disparo perdido |
| Validade | Em development, sempre expira |
Os dados de entrada são conferidos na criação
Se o agente tem campos obrigatórios, o agendamento precisa informá-los — e eles são conferidos contra a versão apontada, no momento da criação, com a mesma preparação de qualquer disparo.
Sem essa conferência, um agente com entrada obrigatória não poderia ser agendado, e o problema apareceria de madrugada.
Se os dados precisarem de correção, há uma ação própria para corrigi-los, que preserva horário, política e histórico. Uma correção recusada não apaga o valor errado — é justamente ele que você precisa ver para corrigir.
Fuso horário
O horário é interpretado no fuso escolhido, com horário de verão tratado corretamente.
Política de concorrência
O que fazer quando chega a hora e a execução anterior ainda está rodando:
| Política | Comportamento |
|---|---|
| Não permitir | O disparo é pulado |
| Permitir | As duas execuções rodam em paralelo |
| Substituir | A anterior é cancelada e a nova começa |
Escolha pensando no efeito: um relatório que grava no mesmo lugar não deve rodar duas vezes ao mesmo tempo.
Disparo perdido
Quando a plataforma esteve indisponível no horário previsto:
| Política | Comportamento |
|---|---|
| Pular | O horário perdido não é recuperado |
| Rodar uma vez | Um disparo é feito na retomada, não um por horário perdido |
Não existe a opção de recuperar todos os horários perdidos: dez horas fora do ar produziriam dez execuções simultâneas.
Falha por dado incompatível
Se o dado de entrada deixa de servir para a versão apontada, o agendamento fica marcado com o problema, visível ao lado dele, e avança o horário para não repetir o disparo inválido em laço.
Ele não é desativado por isso. Antes, uma falha de dado contava como falha transitória e o agendamento se desativava sozinho — do lado de quem configurou, o relatório diário simplesmente parava de chegar, sem explicação.
Duração
| Ambiente | Comportamento |
|---|---|
development | Sempre expira. Um teste esquecido para sozinho |
production | Durável, até ser removido |
Trocar a versão que o agendamento executa
O agendamento aponta para uma versão ativa exata. Publicar uma versão nova não o move: ative a nova versão para que ela passe a ser executada.
Erros comuns
| Sintoma | Causa | O que fazer |
|---|---|---|
| O agendamento não dispara | A versão que ele aponta não está mais ativa | Confira a versão ativa do ambiente |
| Ele parou de rodar após uma mudança | Os dados de entrada não servem mais para a versão | Corrija os dados do agendamento |
| Executou duas vezes no mesmo horário | Política "permitir" com execução longa | Troque a política |
| Rodou em horário inesperado | Fuso horário diferente do esperado | Revise o fuso |
Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.