Instalar um agente
Crie um agente pela web e execute no servidor o comando que a tela fornece, em Linux ou Windows.
Nesta página
Crie o agente no ARGUNIS e depois instale-o no servidor com o comando e a chave que a tela mostra.
Antes de começar
Você precisa da função administrador.
O seu plano precisa ter cota de agentes.
Acesso ao servidor:
Linux: como root. Para a instalação com systemd, o servidor precisa do Node.js 22 ou superior; você também pode instalá-lo com Docker.
Windows: PowerShell como Administrador, no Windows Server 2016 ou posterior, ou Windows 10/11.
Passo 1: criar o agente
Entre em Configurações → Monitoramento → Agentes.
Clique em Novo agente.
Em Servidor onde você o instalará, escolha o servidor se você já o monitora, ou Outro servidor (ainda não monitorado). O agente fica no mesmo grupo do inventário e na mesma categoria do servidor escolhido.
Se você reinstalar o agente em um servidor que já teve um, a lista também mostra os servidores inativos com «Inativo: continuar este servidor». Escolha esse: o novo agente continua o histórico desse servidor em vez de criar um novo.
Opcional: digite o Nome do agente. Se você deixar vazio, ele recebe o nome do servidor seguido de
-agent. Aceita de 2 a 40 letras, números, espaços, pontos, hífens e sublinhados.Clique em Criar agente.
Abre-se uma janela com o nome do agente e as instruções de instalação.
Copie o comando e a chave nesse momento: a chave é mostrada uma única vez, serve para um único host e expira na data que a janela indica. Se você a perder, gere outra com Nova chave.
Passo 2: instalar no Linux
Na janela, escolha a aba Linux.
Em Passo 1 · instale, copie com Copiar o comando do seu tipo de instalação. Se houver mais de um servidor do ARGUNIS ao qual se conectar, você verá um par de comandos para cada um:
systemd (Node.js 22+), para um servidor Linux comum.
Docker, se você preferir rodá-lo como contêiner.
Cole o comando no servidor e execute-o como root.
Em Passo 2 · cole a chave quando o instalador pedir, copie a Chave de instalação (uso único) e cole-a quando o instalador pedir. Ao colá-la, nada aparece na tela: é normal. Pressione Enter.
Em alguns casos a janela mostra outra ordem: primeiro Passo 1 · salve a chave, com um comando para salvá-la em um arquivo protegido (você executa o comando, cola a chave, pressiona Enter e depois Ctrl+D), e em seguida Passo 2 · instale. Siga os passos exatamente como aparecem.
Passo 2: instalar no Windows
Na janela, escolha a aba Windows.
Abra o PowerShell como Administrador no servidor.
Copie o comando de Windows (PowerShell) e cole-o. É uma única linha.
Quando o instalador pedir, cole a Chave de instalação (uso único). Ela não aparece ao colar. Pressione Enter.
Se a aba Windows disser que o instalador do Windows ainda não foi publicado, peça ajuda à Argunis antes de instalar.
Verificar o instalador
Antes de executar, você pode conferir se o instalador é o original. A seção Verificação mostra a URL do instalador e sua impressão digital SHA-256 (no Windows, a do instalador do Windows). No final está a Chave pública do servidor. Com Copiar tudo você copia todas as instruções juntas.
O que acontece depois
Quando o agente se conecta, a lista de Agentes mostra seu status, versão, tipo de instalação e último relatório.
O servidor aparece em Infraestrutura → Servidores com suas métricas. Veja Dados que o agente entrega.