Integre seu primeiro dispositivo
De um console vazio a um primeiro dispositivo online: crie um cliente e um site, gere o instalador do agente, execute-o e confirme que o dispositivo se reporta.
O que é e quando usar
Um dispositivo aparece no SONAR assim que o agente é instalado nele, e o agente é sempre instalado em um site de um cliente. Esta página percorre o caminho completo uma vez (cliente, site, instalador, instalação, verificação) para que você conheça cada tela antes de implantar agentes em escala.
Antes de começar
Um usuário do SONAR cujo papel conceda Manage Clients e Manage Sites (para criar o cliente e o site), Install Agents (para gerar o instalador) e List Agents (para ver o dispositivo no Sysadmin). Se o seu papel estiver limitado a alguns clientes, um cliente que você criar é adicionado aos Allowed Clients do seu papel.
Um computador com uma versão suportada de Windows, Linux ou macOS, e uma conta com direitos de administrador nele (root no Linux e no macOS). Veja Requisitos dos dispositivos.
Esse computador consegue abrir conexões HTTPS de saída na porta 443 para os endereços do seu SONAR. Veja Requisitos de rede.
Passos
Abra Management › Create › Client.
Em Name, digite o nome do cliente, por exemplo
CLIENT-A.Em Default first site, digite o nome do primeiro site dele, por exemplo
SITE-01, e clique em Save. O cliente e o site são criados juntos.Para adicionar mais sites depois, abra Management › Create › Site, escolha o Client, digite o Name e salve.
Abra Agents › Install Agent. A janela Add an agent se abre.
Escolha o Client e o Site aos quais o dispositivo pertence.
Escolha o Operating system, o Agent type (Workstation ou Server) e a Architecture do computador.
No Windows, revise as Optional features e escolha o Installation method. Dynamic (.exe) é o mais simples.
Deixe Enable token expiration (hours) desligado para um primeiro teste, ou ligue-o e defina por quantas horas o instalador continua válido.
Clique no botão na parte inferior da janela (por exemplo, Download Windows installer (.exe)) e leve o arquivo ou o comando até o computador.
Execute o instalador no computador com direitos de administrador. Os passos para cada sistema estão em Instalar o agente no Windows, Instalar o agente no Linux e Instalar o agente no macOS.
No console, abra Dashboard › Sysadmin e clique no cartão do seu cliente no Clients overview.
Encontre o dispositivo pelo nome do host, ou digite-o em Search devices..., e selecione a linha.
O que você deve ver
Depois de Save, a mensagem
CLIENT-A was added, e o cliente aparece como um cartão no Clients overview. Um site adicionado sozinho retornaSite SITE-02 was added!.Com Dynamic (.exe), uma mensagem de que o instalador do seu cliente e site será baixado agora, se ele expira, e de que nenhum argumento de linha de comando é necessário. O arquivo recebe o nome do cliente, do site, do tipo de agente e da arquitetura, por exemplo
sonar-clienta-SITE-01-workstation-amd64.exe.Com os outros métodos, um script para baixar ou um comando para copiar.
No Sysadmin, o cartão do cliente conta um dispositivo, e a lista de dispositivos mostra uma linha para o novo computador.
Como verificar se funcionou
Em Dashboard › Sysadmin, na linha do dispositivo:
Agent Status mostra ONLINE.
Last Response mostra um horário do último minuto ou dos dois últimos, e First Seen mostra quando o agente se registrou.
Client, Site e Type correspondem ao que você escolheu no instalador.
Selecione a linha. Na aba Home do painel do dispositivo:
a barra no topo mostra Online e, assim que o agente de acesso remoto se conectar, Remote Online;
Hardware Details está preenchido (modelo, processador, sistema operacional, memória, rede) poucos minutos depois da instalação. No Linux e no macOS, os campos que o sistema não informa mostram
Not available.
Depois abra Reports & Audits › Audits: há uma entrada Agent Install para o nome do host do dispositivo.
No próprio computador, o serviço do agente está em execução: Sonar Agent Service (sonarrmm) no Windows, sonaragent no Linux e no macOS.
O dashboard Home passa a contar o novo dispositivo em poucos minutos, no próximo recálculo dos seus números.
Erros comuns
Create › Client, Install Agent ou New Agent está esmaecido com You don't have permission for this action
O papel não tem Manage Clients, Manage Sites ou Install Agents
Peça a um administrador que conceda a permissão em Admin Center › Roles
client with this name already exists.
Os nomes de cliente são únicos em todo o console
Escolha outro nome, ou adicione um site ao cliente existente
Client name cannot contain the | character ou Site name cannot contain the | character
O nome contém uma barra vertical
Remova o caractere
O botão de download continua desabilitado
Nenhum cliente ou site está selecionado
Escolha os dois na janela Add an agent
Please enter a valid number of hours
A expiração do token está ligada com um número de horas inválido
Digite um número inteiro de horas, ou desligue a expiração
Installer token has expired. Please generate a new one. no computador
O instalador foi gerado com uma expiração que já passou
Gere um novo instalador
Old installer detected no computador
O instalador foi gerado antes de os agentes no servidor serem atualizados
Gere um novo instalador
Existing installation found em um computador Windows
O agente já está instalado nele
Remova primeiro o agente existente (veja Remover agentes) e depois execute o instalador de novo
A instalação terminou, mas nenhum dispositivo aparece
O computador não consegue alcançar os endereços do SONAR na porta 443
O dispositivo aparece, mas mostra Remote Offline
O agente de acesso remoto ainda não se conectou
Espere alguns minutos; se ele continuar offline, veja Controle remoto
Referência de campos
Create Client
Name
O nome do cliente, exibido na árvore, nos cartões e em todas as listas
Obrigatório. Único. Sem barra vertical
(sem padrão)
Default first site
O nome do site criado junto com o cliente
Obrigatório. Sem barra vertical
(sem padrão)
Custom Fields
Valores dos campos personalizados de cliente, quando houver algum definido em Admin Center › Settings › Custom Fields
Depende do campo
Por campo
Create Site
Client
O cliente ao qual o site pertence
Um cliente existente
(sem padrão)
Name
O nome do site
Obrigatório. Único dentro do cliente. Sem barra vertical
(sem padrão)
Custom Fields
Valores dos campos personalizados de site, quando houver algum definido
Depende do campo
Por campo
Add an agent
Client
O cliente ao qual o novo dispositivo pertence
Um cliente que o seu papel permite
(sem padrão)
Site
O site ao qual o novo dispositivo pertence
Um site do cliente escolhido
(sem padrão)
Operating system
O sistema para o qual o instalador é gerado
Windows, Linux, macOS
Windows
Agent type
Se o dispositivo é uma estação de trabalho ou um servidor. Decide qual política de automação para estações de trabalho ou para servidores se aplica a ele
Workstation, Server
Workstation
Architecture
A arquitetura do processador do computador
Windows: 64-bit, 32-bit. Linux: 64-bit, 32-bit, ARM 64-bit, ARM 32-bit. macOS: Intel 64-bit, Apple Silicon
64-bit (Intel 64-bit no macOS)
Optional features › Sessions
Windows. Instala o módulo de produtividade, que registra a atividade dos usuários e aplica as políticas de acesso
Ligado, desligado
Ligado
Optional features › Geolocation
Windows. O dispositivo informa a sua posição, exibida na aba Location e em Observability › Geolocation
Ligado, desligado
Ligado
Optional features › Remote access
Windows. Ativa a Área de Trabalho Remota do Windows no computador
Ligado, desligado
Ligado
Optional features › Ping
Windows. Permite que o computador responda a ping através do Firewall do Windows
Ligado, desligado
Ligado
Optional features › Disable sleep/hibernate
Estações de trabalho. Desativa a suspensão e a hibernação para que o dispositivo continue alcançável. Aplica-se no Windows
Ligado, desligado
Ligado
Installation method
Windows. Como o instalador é entregue: Dynamic (.exe), um instalador pronto para executar; PowerShell, um script; Manual, um comando para você mesmo executar. O Linux recebe um script de instalação (.sh) e o macOS um comando, sem escolha a fazer
Dynamic (.exe), PowerShell, Manual
Dynamic (.exe)
Enable token expiration (hours)
Limita por quanto tempo o instalador pode registrar novos dispositivos. Desligado, o instalador não expira
Desligado, ou um número de horas
Desligado; 24 horas quando ligado
Páginas relacionadas
Atualizado
Isto foi útil?