Tarefas agendadas
Gerenciar jobs automáticos dos módulos Core, Graph, OLT e ACS — frequência, execução e logs.
Tarefas agendadas
Menu: Sistema → Configurações → Tarefas Agendadas
Rota no sistema: /systemParameters/tasks
Centraliza jobs em segundo plano de todos os módulos: limpeza de backups, estatísticas, sincronizações OLT, rotinas ACS, etc.
Cartões de resumo
| Cartão | Significado |
|---|---|
| Total | Todas as tarefas cadastradas. |
| Habilitadas | Rodarão conforme o cron configurado. |
| Em execução | Jobs disparados e ainda não finalizados. |
| Falharam | Última execução com erro. |
Filtro por módulo
Abas no topo da tabela:
| Aba | Conteúdo típico |
|---|---|
| Todas | Visão completa. |
| Graph | Estatísticas, processamento CPE, relatórios. |
| OLT | Sincronização de ONUs, inventário. |
| Core | Limpeza de backups, agendamento de backups do sistema, sincronização de clientes (ERP). |
| ACS | Rotinas TR-069 (quando licenciado): aplicar persistência, limpeza de CPEs inativos. |
O número entre parênteses é a quantidade de tarefas naquele módulo.
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Nome | Título e descrição curta da tarefa. |
| Módulo | Badge colorido (Core, Graph, OLT, ACS). |
| Frequência | Ex.: A cada 5 minutos, Diário 02:00. |
| Última execução | Quando rodou e duração (ex.: agora · 3ms). |
| Status | Pendente, Sucesso, Falhou, Executando. |
| Habilitada | Interruptor liga/desliga sem apagar a tarefa. |
Menu ⋮: Editar, Executar agora, Ver logs, Histórico, Excluir.
Criar nova tarefa
+ Nova Tarefa abre o formulário:
| Campo | Descrição |
|---|---|
| Módulo | Core, Graph, OLT ou ACS. |
| Tarefa | Comando pré-definido pelo backend (lista depende do módulo). |
| Descrição | Texto livre para documentar o propósito. |
| Frequência | De a cada minuto até mensal; tarefas diárias pedem horário (ex.: 02:00). |
| Sem sobreposição | Não inicia nova execução se a anterior ainda está rodando. |
| Executar em background | Comando em segundo plano no servidor. |
| Habilitada | Se desligada, permanece cadastrada mas não agenda execuções. |
Algumas tarefas exibem Configurações extras (ex.: dias de retenção de backup, fabricante OLT, seleção de CPEs).
Tarefas Core comuns: Limpeza de Backups (diária) e Agendamentos de Backup (a cada 5 minutos) — coordenam a política de retenção com a área de Backups.
Sincronizar clientes (ERP)
A tarefa Sincronizar clientes (ERP) (módulo Core) dispara a importação de assinantes de todas as integrações de ERP habilitadas (ATLAZ, IXC, RBX). É a forma recomendada de manter o cadastro atualizado sem intervenção manual.
- Módulo: Core · Tarefa: Sincronizar clientes (ERP)
- Frequência sugerida: de hora em hora ou algumas vezes ao dia, conforme o volume de assinantes.
- Marque Sem sobreposição para não iniciar uma nova sincronização enquanto a anterior ainda roda.
Detalhes da configuração e do resultado de cada execução em Integrações de clientes (ERP).
Limpeza de CPEs Inativos
A tarefa Limpeza de CPEs Inativos (módulo ACS) remove da base do ACS os CPEs que pararam de se comunicar com a plataforma. A cada execução ela varre os dispositivos registrados e exclui todo aquele cujo último inform seja mais antigo que o prazo configurado.
- Módulo: ACS · Tarefa: Limpeza de CPEs Inativos
- Frequência sugerida: diária, em horário de baixo movimento.
- Configuração: Dias sem comunicação — obrigatório, de 1 a 3650.
O que é apagado
| Dado | Apagado? |
|---|---|
| Dispositivo no ACS | Sim |
| Persistência salva do CPE (parâmetros capturados) | Sim |
| CPE processado (snapshot) | Não |
| Históricos (diagnósticos, sinal óptico) | Não |
| Analytics | Não |
A remoção segue esta ordem: primeiro o dispositivo é excluído do ACS e só então a persistência dele é apagada. Se o ACS recusar a exclusão, a persistência é preservada e a execução termina como Falhou — nada fica pela metade.
Quem não é removido
CPEs que nunca informaram (sem data de último inform registrada) são preservados de propósito, independentemente do prazo configurado.
A exclusão é definitiva — o CPE some do ACS e precisa informar novamente para voltar à base. O campo Dias sem comunicação não tem valor padrão justamente para evitar disparo acidental: sem preenchê-lo, a tarefa falha em vez de varrer toda a base. Comece com um prazo folgado (ex.: 180 dias), confira o resultado em Logs, e só então reduza.
Os perfis e valores capturados pela persistência são descritos em Persistência de parâmetros.
Executar manualmente
Executar agora dispara a tarefa fora do horário — útil para testar após mudança de configuração. Pode abrir o visualizador de logs em tempo real.
Logs e histórico
- Logs — saída stdout/stderr da execução atual ou recente.
- Histórico — execuções passadas com status, duração e quem disparou (agendador ou manual).
Boas práticas
- Mantenha desabilitadas tarefas que não usa — reduz carga no servidor.
- Use sem sobreposição em jobs longos (backup, sync massivo).
- Monitore a aba Falharam após atualizações do sistema.
- Evite frequências agressivas (a cada minuto) sem necessidade operacional.