Instalar uma sonda de monitoramento
Registre uma sonda pela web e execute em uma máquina da sua rede o comando de um único passo com o token dela.
Nesta página
Registre a sonda no ARGUNIS e depois instale-a em uma máquina da sua rede com o comando e o token que a tela fornece.
Antes de começar
Você precisa da função administrador.
O seu plano precisa ter cota de sondas de monitoramento. Se estiver cheia, o botão Registrar sonda fica desabilitado e a tela diz por quê.
Uma máquina na sua rede com Docker no Ubuntu 22.04/24.04 ou Debian 12, amd64 ou arm64, 2 vCPU, 2 GB de RAM e 15 GB livres. Ela precisa alcançar os hosts que você vai monitorar.
Acesso por SSH a essa máquina.
Passo 1: registrar a sonda
Entre em Configurações → Monitoramento → Sondas de monitoramento.
Clique em Registrar sonda. Abre-se Registrar sonda de monitoramento.
Digite o Nome, por exemplo sonda-escritorio-central. Aceita de 2 a 40 letras, números, espaços, pontos, hífens e sublinhados.
Se houver mais de um servidor do ARGUNIS disponível, escolha o Servidor ao qual se conectará.
Opcional: se você reinstalar a sonda em uma máquina que já teve uma, escolha o servidor inativo dela em Continua o servidor: a nova sonda continua o histórico dele. Com Nenhum (servidor novo), um novo é criado. O campo só aparece se houver servidores inativos.
Clique em Registrar e gerar chave.
Abre-se uma janela com as instruções de instalação.
Copie o token nesse momento: ele é mostrado uma única vez, expira em 24 horas e serve para uma única sonda. Se você o perder, gere outro com Reinscrever.
Passo 2: instalar na máquina
Conecte-se por SSH à máquina da sonda.
Em Passo 1 · na máquina da sonda (por SSH), cole o comando, copie com Copiar o Comando de instalação (um único passo) e cole-o na máquina.
Em Passo 2 · cole o token quando o instalador pedir, copie o Token de instalação (uso único) e cole-o quando o instalador pedir. Ao colá-lo, nada aparece na tela: é normal. Pressione Enter.
O token já diz a qual servidor do ARGUNIS se conectar: o instalador não pergunta mais nada.
Se você preferir Portainer ou docker compose, o token também serve como variável de um stack. A tela indica isso em Instalar uma sonda.
O que o instalador faz
Instala o Docker e o Portainer se faltarem, baixa e verifica a imagem assinada da sonda e cria o stack argunis-sonda-monitoreo no Portainer. Pelo Portainer você pode ver a sonda e seus registros.
O que acontece depois
Ao terminar, a sonda aparece conectada na lista de Sondas de monitoramento.
O servidor dela aparece em Infraestrutura com o rótulo Sonda de monitoramento.
Você já pode escolhê-la em Verificar a partir de ao Adicionar um host, nos Descobrir hosts na sua rede e nos testes de monitoramento.
Status na lista
Status | O que significa |
|---|---|
pendente · aguardando instalação | Registrada, ainda não instalada. |
ativa · conectada | Instalada e on-line. |
ativa · sem conexão | Instalada, mas não informa. Verifique a máquina. |
revogada | Não pode mais se conectar. |
A lista também mostra a versão e a arquitetura, o servidor próprio e quantas instruções ela tem e quantas falham.