DocumentaciónAjuda

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

  1. Entre em Configurações → Monitoramento → Agentes.

  2. Clique em Novo agente.

  3. 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.

  4. 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.

  5. 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

  1. Na janela, escolha a aba Linux.

  2. 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.

  3. Cole o comando no servidor e execute-o como root.

  4. 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

  1. Na janela, escolha a aba Windows.

  2. Abra o PowerShell como Administrador no servidor.

  3. Copie o comando de Windows (PowerShell) e cole-o. É uma única linha.

  4. 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.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar