Buscar K
Aparência
Gerenciamento de Agentes
O Agente é o componente fundamental do HorusETL — é o software que reside na sua infraestrutura (ou na nuvem) e executa o processamento de dados. O painel de Gerenciamento de Agentes permite criar tokens de autenticação, monitorar o status e realizar manutenções remotas.
TIP
Multi-Tenancy: Um único agente pode atender múltiplos tenants simultaneamente. É possível ter 100 ou mais tenants conectados ao mesmo agente, economizando recursos de infraestrutura.
🔑 Criando um Novo Agente
Para instalar um novo agente, você primeiro precisa criar um Token — a chave que vincula o executável na sua máquina ao seu ambiente no Horus.
- Acesse o menu Agentes
- Clique no botão Criar novo Agente
- Preencha as configurações iniciais:
- Descrição — Um nome para identificar onde este agente está rodando (
Servidor-Principal-01,Laptop-Dev) - Agendamentos Simultâneos (Paralelismo) — Define quantos fluxos este agente pode executar ao mesmo tempo. Recomendação: entre 2 e 4 para máquinas padrão; para servidores mais potentes, aumente para 10, 16 ou mais. Atenção: agendamentos de um mesmo tenant são serializados, e o paralelismo atua entre tenants diferentes (ver Requisitos de Hardware para entender o impacto no dimensionamento)
- Descrição — Um nome para identificar onde este agente está rodando (
- Clique em Salvar
- O sistema irá gerar um Token. Copie este código e use-o durante a instalação do agente ou na variável de ambiente Docker
NOTE
O token é exibido apenas uma vez por motivos de segurança. Se perdê-lo, gere um novo ou consulte a opção de visualização de token (ícone de "olho"), se tiver permissão.
📡 Monitoramento de Status
Na listagem de agentes, você pode acompanhar o status em tempo real:
| Status | Indicador | Descrição |
|---|---|---|
| Online | 🟢 Verde | O agente está conectado e pronto para receber comandos |
| Offline | 🔴 Vermelho | O agente não está se comunicando — verifique se o serviço está rodando e se há conexão com a internet |
Ao clicar em um agente, você vê detalhes técnicos como:
- Nome do Servidor (Hostname)
- Sistema Operacional
- Uso de CPU e Memória (RAM)
- Versão do Agente
🔄 Atualização de Versão
O HorusETL recebe atualizações frequentes com novos conectores e correções.
NOTE
Auto-Atualização Linux: Quando um agente inicia, ele automaticamente verifica com o backend qual é a versão mais recente disponível. Se detectar que está desatualizado, ele baixa a nova versão e aplica a atualização automaticamente.
Agentes Windows
Agentes instalados via MSI no Windows podem ser atualizados remotamente:
- Abra o painel do Agente
- Se houver uma atualização disponível, o botão Atualizar Agente estará visível
- Clique no botão — o agente irá baixar a nova versão, parar o serviço, aplicar a atualização e reiniciar automaticamente (processo leva alguns minutos)
Agentes Linux (Docker)
Agentes rodando em Docker não são atualizados pelo botão do painel:
- A atualização é automática ao reiniciar o container
- Simplesmente reinicie o agente para que ele baixe a nova imagem e aplique as mudanças
🔧 Ações de Manutenção
Dentro do painel do agente, as seguintes ações de emergência estão disponíveis:
| Ação | Descrição |
|---|---|
| Reiniciar Agente | Envia um comando para o serviço reiniciar. Útil se o agente estiver travado ou com comportamento estranho |
| Zerar Fila | Remove todos os agendamentos pendentes que ainda não começaram a rodar. Útil se você disparou acidentalmente muitas execuções e quer cancelar |
| Transferir Dataflows | Move a responsabilidade de execução de fluxos de um agente antigo para um novo |
⚠️ Troubleshooting: Múltiplas Réplicas
Se você vir um alerta amarelo de Múltiplas Réplicas Detectadas, significa que dois ou mais computadores diferentes estão usando o mesmo Token.
WARNING
Nunca use o mesmo token em máquinas diferentes simultaneamente. Isso causa um conflito onde os agentes disputam as tarefas, gerando erros intermitentes e logs espalhados.
- Solução — Desligue os agentes excedentes ou crie um novo Token para cada máquina adicional