Buscar K
Aparência
Manter o Agente ETL
- Tipo
- Como fazer
- Para
- Engenharia de dados
- Na tela
- HorusETL › Configurar Agentes ETL
Atualizar a versão, destravar a fila, mudar o paralelismo e passar Dataflows de uma máquina para outra se fazem na tela do Agente ETL, aberta em Configurar Agentes ETL pelo nome dele. Para instalar um Agente novo, ver Instalar o Agente ETL.
Antes de começar
Reiniciar, zerar a fila e atualizar exigem o Agente com a Situação do agente: em Online; com ele offline, os botões não aparecem.
Atualizar a versão
A versão em uso aparece em Versão do Agente ETL. Recursos novos pedem versão mínima, listada em Versões do Agente ETL.
No Windows: clique em Atualizar Agente ETL. O Agente baixa o instalador novo, aplica e volta sozinho; o processo leva alguns minutos.
No Docker: clique em Reiniciar Agente ETL, ou rode docker compose restart na máquina. Ao subir, o container baixa a versão mais nova do Agente e a guarda no volume /data. Não é preciso puxar imagem nova. Se o download falhar, ele sobe com a versão que já está no volume.
Reiniciar
Clique em Reiniciar Agente ETL quando o Agente estiver online mas sem executar nada. O Lumo manda a ordem pela conexão aberta e o serviço volta sozinho.
Zerar a fila
Clique em Zerar Fila para esvaziar a fila do Agente. Os agendamentos que esperavam a vez são descartados, e as execuções em andamento são interrompidas: o Agente encerra os processos que estão rodando. Serve quando a fila acumulou, por exemplo depois de o Agente passar horas offline ou de vários disparos por engano, ou quando uma carga travou. Os agendamentos continuam cadastrados.
Ajustar o paralelismo
| Campo | O que controla |
|---|---|
| Agendamentos Simultâneos: | quantos agendamentos o Agente roda ao mesmo tempo, de 1 a 16 |
| Execuções paralelas fora da fila: | quantos agendamentos marcados com Executar em paralelo, sem esperar a fila rodam juntos, fora do limite acima; zero desliga essa pista |
Os agendamentos de um mesmo Tenant rodam um de cada vez, então Agendamentos Simultâneos: só faz diferença num Agente que atende vários Tenants. Para um Tenant cujos agendamentos se acumulam, o caminho é espaçar, encurtar os Dataflows ou usar a pista paralela para os agendamentos leves. Ver Dimensionar o Agente ETL.
Ler os logs do Agente
O painel Logs do Agente ETL, na mesma tela, mostra o log do próprio serviço do Agente, útil quando o problema é do Agente e não de uma carga. Ele aparece a partir da versão 1.18. O log de cada carga fica no agendamento e no Dataflow; ver Status e mensagens.
Trazer Dataflows de outro Agente
Na tela do Agente que vai receber os Dataflows, clique em Transferir Dataflows. A janela lista os Dataflows dos outros Agentes do Tenant; marque os que vêm e confirme.
Se um agendamento tem Dataflows que vão e Dataflows que ficam, ele é dividido: uma cópia vai para o Agente novo com os transferidos, e o original fica com os demais. Antes de transferir, a janela pede confirmação em Agendamentos serão divididos, com quantos Dataflows de cada agendamento vão.
As conexões dos Dataflows também pertencem a um Agente. Para levá-las junto, marque Transferir conexões usadas pelos dataflows selecionados na mesma janela (vem desmarcado). Uma conexão avulsa se transfere em Transferir, no painel Agente ETL dela; ver Cadastrar uma conexão de banco.
Desativar ou excluir
Desmarcar Agente ETL Ativo e salvar faz o Agente deixar de receber os agendamentos do Tenant. Agendamentos, Dataflows e conexões continuam cadastrados e voltam a rodar quando você marcar de novo.
Excluir Agente ETL apaga o Agente e tudo o que está atrelado a ele: configurações, agendamentos e Dataflows. Antes de excluir, transfira para outro Agente o que precisa continuar rodando.
Se der errado
O botão Atualizar Agente ETL não aparece. O Agente está offline ou não roda no Windows. No Docker, a atualização é pelo reinício.
A versão não muda depois de reiniciar o container. O container não alcança storage.horusbi.com.br e subiu com a versão do volume. Confira a saída para os endereços de Rede e segurança.
Relacionado
Pelo Lumo CLI
Este recurso também pode ser criado e versionado em YAML. Veja a referência de agent.