O painel do agendador explicado

Trabalho agendado é fácil de esquecer até não acontecer. O painel do agendador no Dailybot existe para ops e gestores enxergarem o tempo como dimensão de primeira classe: o que deveria ter disparado, o que disparou e o que precisa de atenção. Este tour foca em ler a interface e usar isso na prática para resolver problemas.

Visões principais: próximas, histórico e agendas ativas

Próximas execuções responde o planejamento: “o que vai rodar a seguir?” Vocês devem ver uma linha do tempo ou lista ordenada pelo próximo horário, com contexto suficiente (nome do fluxo, escopo, fuso) para checar sobreposição. Se dois jobs pesados caem no mesmo minuto, isso aparece aqui antes de virar problema de rate limit.

Histórico de execuções é a trilha de auditoria: execuções passadas com timestamps, indícios de duração e resultado. É onde confirmam se o digest de ontem à noite realmente rodou ou se só a mensagem no Slack chegou enquanto um passo downstream não completou.

Agendas ativas (às vezes em outra aba ou painel) listam as definições ainda ativas: expressões cron, fluxo responsável e toggles ligado/desligado. Quando alguém diz “desliguem o rollup de sexta”, aqui confirmam o job certo—não um de teste com nome parecido.

Lendo a linha do tempo

Uma linha do tempo boa conta três histórias: o que rodou (checks e logs), o que vem a seguir (fila à frente) e o que falhou (erros ou alertas). Olhem à frente por buracos: se “próxima execução” pula longe demais, investiguem pausas, janelas de manutenção ou fluxos desabilitados.

Em cada entrada, notem o escopo: jobs em nível de org versus jobs com escopo de time se comportam diferente quando a membresia muda. Um run ligado a um time obsoleto pode aparecer como ignorado até reatribuírem dono.

Filtros: agente, time, fluxo

Filtros transformam um painel barulhento em sinal. Dimensões típicas:

• Nome do fluxo ou automação — isolar um playbook.
• Escopo de time ou canal — ver só digest de customer success.
• Agente ou integração — separar check-ins humanos de jobs movidos a agente.

Usem filtros ao depurar um caso isolado (“meu lembrete nunca chegou”) sem perder o contexto global de outras agendas.

Status de execução

Concluído significa que o agendador entregou ao executor de automações e o fluxo reportou sucesso ponta a ponta—ainda assim façam spot checks nas saídas, porque “verde” pode esconder bug de lógica.

Ignorado costuma ligar a condições: o relógio disparou, mas pré-requisitos não passaram (coorte vazia, feature flag desligada ou “sem dados novos desde a última rodada”). Ignorado não é ruim por si só; vira problema só quando esperavam trabalho.

Falhou indica erro: timeout de integração, mudança de permissão, payload inválido ou cota estourada. Abram o detalhe da execução para texto de erro e IDs de correlação que o suporte possa usar.

Tentando novamente mostra tratamento de falha transitória: a plataforma pode esperar e retentar. Fiquem de olho em jobs presos em retry—em geral sinal de credencial ou configuração quebrada de forma persistente, não um glitch de rede.

Corrigindo execuções perdidas ou com falha

Partam do histórico, não do chat. Confirmem se existe alguma linha. Se não há linha, a agenda pode estar desabilitada, o fluxo removido ou o fuso mudou. Se há linha ignorada, leiam o motivo antes de rodar manualmente.

Para linhas falhas, corrijam a causa primeiro (renovar token, ajustar escopo) e só então usem retry se o produto oferecer; retry cego sem correção gasta cota e polui logs.

Documentem a cadência esperada por job crítico (dono, propósito de negócio, escalação). O painel fica mais forte junto de uma nota de ops de uma página: “Se X não postar até 09:05 UTC, vejam Y”.

Hábitos para gestores e ops juntos

Gestores devem saber onde olhar e quem é dono das agendas; ops deve manter definições limpas (sem dois crons duplicados fazendo a mesma coisa). Uma varredura semanal de cinco minutos em falhas evita surpresas de fim de mês quando todos assumiram que a automação ainda rodava.

Usado de forma consistente, o painel do agendador transforma jobs de fundo invisíveis em infraestrutura observável—a diferença entre torcer para o bot lembrar e saber que ele lembrou.