Jobs & RotinasMódulo 04 · Automação
Saiba quando a rotina da madrugada falhar
Jobs & Rotinas acompanha crons, jobs e processos em segundo plano de qualquer sistema. A rotina avisa a T.I ZONE quando começa, quando está viva e quando termina; se ela falhar ou parar de dar sinal, isso vira um achado com o histórico da execução. E também dá para agendar e executar as rotinas pela própria plataforma.
- 7
- linguagens para executar código
- 3
- políticas de concorrência
- 4
- sinais por execução
01 O problema
A rotina da madrugada falhou e só descobriram de manhã.
Para quem é: Desenvolvedores e operações que dependem de faturamento, integrações noturnas, sincronizações e filas.
- 01
Falhou de madrugada, descobriram de manhã
O faturamento, o backup ou o envio de notas não rodou, e ninguém recebeu aviso. O prejuízo aparece horas depois.
- 02
Rodou, mas travou
O processo continua “em execução” há horas. Não falhou, então nenhum log de erro chama atenção.
- 03
Cron espalhado
Cada servidor tem seu agendador, sem histórico, sem dono e sem saber o que depende de quê.
02 Recursos
Tudo o que o módulo Jobs & Rotinas faz
31 recursos em 5 áreas, na mesma organização do menu do console.
Linguagens e ferramentas
- API
- Hangfire
- Quartz
- BullMQ
- Laravel Queues
- Celery
- Node.js
- Python
- C#
- PHP
- Go
- Java
- Shell
Observação de rotinas
11 recursos
Visão geral
01.01Rotinas cadastradas, ativas, achados abertos e a saúde de cada uma.
Cadastro com expectativa
01.02Ambiente, responsável e de quanto em quanto tempo a rotina deve dar sinal.
Eventos por API segura
01.03Início, heartbeat, conclusão e falha, enviados pela rotina com credencial máquina a máquina.
Sem execução duplicada
01.04O mesmo evento enviado duas vezes, ou fora de ordem, não cria outra execução.
Rotina travada
01.05Se o heartbeat para de chegar no prazo esperado, a rotina é marcada como travada.
Falha explícita
01.06Quando a rotina informa erro, a falha fica registrada na execução.
Achados
01.07Rotina travada e rotina com falha aparecem como achados abertos, com o histórico.
Pausar, reativar e arquivar
01.08Controle cada rotina sem perder as execuções anteriores.
Anomalia de duração
01.09Aviso quando a rotina roda muito mais rápido ou mais devagar que o normal.
Leitura direta dos agendadores
01.10Histórico lido do Hangfire, Quartz, BullMQ, Laravel Queues e Celery.
Webhook de falha
01.11Seu sistema avisa só quando uma exceção não foi tratada.
Execuções e logs
6 recursos
Histórico de execuções
02.01Rotina, identificador externo, resultado (em execução, concluída, falhou, travada), início e fim.
Detalhe de cada execução
02.02Eventos recebidos, horário em que aconteceram, horário em que chegaram e atraso.
Linha do tempo do dia
02.03Visão Gantt das janelas de execução de todas as rotinas.
Taxa de sucesso e duração média
02.04Por rotina, ao longo do tempo.
Logs em tempo real
02.05Saída stdout e stderr ao vivo, com pausa, reconexão e aviso de lacunas.
Stack trace e código de saída
02.06O motivo do erro junto da execução que falhou.
Agendamento e execução
6 recursos
Construtor visual de cron
03.01Expressões * * * * * sem decorar a sintaxe, com fuso horário e prévia das próximas execuções.
Gatilhos
03.02Recorrente, por evento ou execução única numa data futura.
Chamada HTTP autenticada
03.03Dispara um endpoint do seu sistema, em qualquer linguagem, com cabeçalhos e token.
SQL e stored procedures
03.04Execução no banco já cadastrado no módulo Bancos de Dados.
Código isolado
03.05Node.js/TypeScript, Python, C#, PHP, Go, Java e Shell, sem servidor próprio, com cofre de segredos.
Agente no seu servidor
03.06Um agente leve para rodar scripts e comandos locais agendados.
Filas e workers
3 recursos
Fila acumulando
04.01Profundidade e atraso da fila quando os workers não dão vazão.
Dead letter queue
04.02Mensagens que falharam e mensagens envenenadas.
Workers
04.03Consumo por worker, capacidade e workers desconectados.
Políticas e alertas
5 recursos
Tempo limite
05.01Evita loop infinito e rotina presa para sempre.
Concorrência
05.02Bloquear (Forbid), permitir em paralelo (Allow) ou substituir a execução anterior (Replace).
Novas tentativas
05.03Retry automático com recuo exponencial para erros temporários.
Ações manuais
05.04Executar agora, pausar agendamento, reexecutar e forçar interrupção.
Alertas e chamados
05.05Aviso no Slack, Discord, Telegram, SMS ou WhatsApp e chamado P1/P2 aberto sozinho.
03 Como funciona
Como funciona o monitoramento de rotinas
- 01
Cadastre a rotina
Nome, ambiente, responsável e o prazo esperado entre um sinal e outro.
- 02
A rotina dá sinal
No início, durante e no fim, ela chama a API da T.I ZONE com uma credencial própria.
- 03
Silêncio vira achado
Se o sinal não chega no prazo ou a rotina informa erro, a execução é marcada.
- 04
Investigue pelo histórico
Veja cada evento, com horário de ocorrência, de chegada e atraso.
04 Conexões
Um problema quase nunca fica numa área só
O módulo Jobs & Rotinas troca informações com outras áreas da T.I ZONE, no mesmo login e com o mesmo histórico.
- Bancos de DadosStored procedures agendadas no banco cadastrado.Conhecer
- Chamados & ProjetosFalha crítica abre chamado com os detalhes do erro.Conhecer
- Analytics HubHistórico de execuções nos relatórios.Conhecer
- IAM & GovernançaCredenciais máquina a máquina com escopo e validade.Conhecer
Incluído em todos os módulos
- Várias organizaçõesDados isolados por organização, com troca rápida para quem atende mais de uma.
- Auditoria nominalCada alteração registra quem fez, o quê e quando.
- Catálogo de serviçosTodos os módulos num índice com busca, categorias e favoritos fixados no início.
- Saúde do ambienteConectividade de banco, cache e armazenamento da plataforma num painel próprio.
05 Perguntas
Perguntas sobre Jobs & Rotinas
Respostas diretas, sem letra miúda.
O que é monitoramento de cron e jobs?
É acompanhar se as tarefas agendadas e os processos em segundo plano rodaram quando deveriam, no tempo esperado e sem erro, e ser avisado quando isso não acontece.
Como a rotina avisa a T.I ZONE?
Ela faz chamadas HTTP autenticadas para a API da plataforma no início, durante a execução (heartbeat), na conclusão e em caso de falha.
Funciona com qualquer linguagem?
Sim. Qualquer sistema que consiga fazer uma requisição HTTP pode enviar os eventos. Se você usa Hangfire, Quartz, BullMQ, Laravel Queues ou Celery, a T.I ZONE também lê o histórico direto deles.
Como descobrir que uma rotina travou?
Pelo heartbeat. Você define de quanto em quanto tempo a rotina deve dar sinal; se o sinal para de chegar, a T.I ZONE marca a execução como travada, mesmo sem nenhum erro.
E se o mesmo evento chegar duas vezes?
A execução não é duplicada. Eventos repetidos ou fora de ordem são reconhecidos pelo identificador da execução.
Dá para agendar e executar rotinas pela T.I ZONE?
Sim. Monte o cron num construtor visual e escolha como executar: chamada HTTP, stored procedure, código isolado em Node.js, Python, C#, PHP, Go, Java ou Shell, ou um agente no seu servidor.
06 Lista de espera
Garanta seu acesso antecipado à T.I ZONE
O acesso é liberado por etapas. Conte um pouco sobre sua empresa e o que você mais precisa resolver hoje. Essas respostas ajudam a definir as prioridades da plataforma.
- Acesso antes da abertura
- Novidades dos módulos em primeira mão
- Suas necessidades ajudam a definir as prioridades
- Planos anunciados primeiro para a lista
