Sphere Agent

agente remoto que é instalado como serviço nos sistemas operacionais windows e linux utilizado para coleta de métricas do ambiente e responsável por executar a automação remota compatibilidade de os o sphere agent funciona nas versões linux (oracle/centos/rhel/ubuntu/suse/amazon linux) e windows (2008 ou superior) de 64 bits confira mais detalhes na seção requisitos do sistema procedimento de instalação para pré configurar o repositório de agents, execute o comando abaixo na sua instância masternode simonctl repo vamos entender a estrutura dos arquivos do agent sphere agent/ # raiz do agent plugins/ # diretorio dos plugins do sphere queue/ # diretorio temporario de metricas atmosphere yaml # arquivo de configuração principal config yaml # arquivo de configuração de coleta sphere agent log # arquivo de log do agent arquivo de configuração (atmosphere yaml) esta é a principal configuração que determina qual o servidor do simon na rede e atributos essenciais do host como permissão de automação e configuração automática do arquivo de coleta /opt/apps/simon/public/repo/atmosphere yaml modificar hostname modificar para o ip do host ou domínio público; port modificar para a porta 80 ou 443; adicionar ao arquivo path /sphere sync scheme http ou https salve o arquivo e copie o para os destinos /opt/apps/simon/public/repo/sphere agent linux /opt/apps/simon/public/repo/sphere agent windows arquivo de configuração (config yaml) determina a configuração dos plugins, períodos de coleta, proxy, etc este arquivo é configurado automaticamente através do atmos (exige a configuração antecipada do arquivo /opt/apps/simon/public/repo/sphere agent linux/config yaml ) modificar hostname modificar para o ip do host; port modificar para a porta 80 adicionar ao arquivo path /sphere sync salve o arquivo e copie o para os destinos /opt/apps/simon/public/repo/sphere agent linux /opt/apps/simon/public/repo/sphere agent windows rodar o comando para criar o arquivo zipado para os ambientes linux/windows linux tar zcvf sphere agent linux x64 tar gz sphere agent linux/ windows zip 9 r /sphere agent windows x64 zip /sphere agent windows editar o arquivo /opt/apps/simon/public/repo/update sphere agent sh localizar a linha referente ao "agent url", deixando com as seguintes informações ambiente interno agent url="${agent url http //ip simon/repo/${compressed file}}" ambiente publicado agent url="${agent url https //url simon/repo/${compressed file}}" editar o arquivo /opt/apps/simon/public/repo/update sphere agent ps1 localizar a linha referente ao "\[string]$agenturl", deixando com as seguintes informações ambiente interno \[string]$agenturl = “http //ip servidor/repo/${compressedfile}, ambiente publicado \[string]$agenturl = “https //url simon/repo/${compressedfile}, requisitos para instalação espaço livre 500mb (mínimo recomendado) volume de instalação linux /opt sub diretório /sphere agent linux /sphere agent linux windows c /programdata/65a sub diretório /sphere agent windows instalação automática procedimento recomendado e disponivel a partir da versão 3 0 0+ on premises e agent pré configurado para realizar a primeira instalação e principalmente nas distribuições on premises, é recomendado substituir o endereço apontando para a url do servidor principal do simon, desta forma o download será realizado na rede interna e o agent estará automaticamente configurado para este ambiente recomendação de atualização recomendamos que antes da atualização do agent verifique o espaço em disco disponível e confirme se a url utilizada condiz com o tipo de instalação desejada linux (64 bits) execute uma das opções de comando abaixo no terminal, a instalação será iniciada e exibirá o log do progresso no console \# (opção 1) utilizando curl curl k http //\<simon master node>/repo/update sphere agent sh | sudo sh \# (opção 2) utilizando wget wget o http //\<simon master node>/repo/update sphere agent sh | sudo sh com este mesmo comando é possível realizar a atualização do agent quando disponível, um aviso será observado na tela de infraestrutura do atmos windows (64 bits) faça o download do arquivo no repositório do simon através da url como no exemplo http // http // \<simon master node> /repo/update sphere agent ps1 execute o powershell como administrador e rode o comando abaixo \# acesse a pasta onde encontra se o arquivo baixado e execute o comando powershell exe executionpolicy bypass file \update sphere agent ps1 instalação manual windows (64 bits) faça o download do agent para windows https //65a internal sa s3 sa east 1 amazonaws com/repo/latest/sphere agent windows x64 zip https //65a internal sa s3 sa east 1 amazonaws com/repo/latest/sphere agent windows x64 zip salve o arquivo na pasta de serviços desejados, recomendamos a pasta c \programdata\65a descompacte o arquivo baixado (se houver, escolha a opção "extrair aqui”) acesse a pasta criada e execute o arquivo no powershell \install service ps1 confirme no gerenciador de serviços do windows se o processo “sphere agent” foi iniciado, caso contrário, inicie o serviço reiniciar o serviço (após modificar o config yaml), no powershell restart service name "sphere agent" linux (64 bits) faça o download do agent para linux wget o /opt/sphere agent linux tar gz https //65a internal sa s3 sa east 1 amazonaws com/repo/latest/sphere agent linux x64 tar gz https //65a internal sa s3 sa east 1 amazonaws com/repo/latest/sphere agent linux x64 tar gz salve o arquivo na pasta de serviços desejados, recomendamos uma das pastas /opt/ /srv/ /usr/src descompacte o arquivo na pasta ou via comando no terminal tar zxvf sphere agent linux x64 tar gz acesse a pasta criada e execute o comando no terminal\ sudo bash /install service sh confirme o status do serviço rodando um dos comandos no terminal\ sudo systemctl status sphere agent reiniciar o serviço no terminal (após modificar o arquivo config yaml)\ sudo systemctl restart sphere agent arquivos de configuração confira o arquivo config yaml se a seção output server foi configurada corretamente caso já tenha iniciado o serviço, realize as mudanças no arquivo config yaml e em seguida reinicie o serviço exemplo do atmosphere yaml apiversion v1 # versão da api do simon kind host # tipo do item de configuração metadata namespace default # namespace deste host domain "\<root domain>" # nome do dominio raiz annotations # anotações locais do host atmosphere/host services '\[]' # lista de serviços mapeados config hostname "127 0 0 1" # ip/hostname do simon api key "\<atmosphere api>" # chave da api scheme http # (opcional) se utilizar ssl / default http port 18001 # ssl 443, default 18001 path /sphere sync path / # /sphere sync (se utilizar proxy 80/443) agent # configurações do agent local self update true # atualizações automáticas do agent com este arquivo presente na pasta de configuração será possível controlar as configurações do agent remotamente (via atmos ) remoção do agent linux \# utilize o arquivo uninstall sh para remover o agent sudo bash /opt/sphere agent linux/uninstall sh \# remover as pastas do agent rm rf /opt/sphere agent linux \# bonus se o atmosphere (módulo de automação) tiver instalado \# remover as pastas do atmosphere rm rf /opt/ atmosphere aviso cuidado ao utilizar o comando " rm rf " apontando somente as pastas do agent informadas acima windows ao utilizar o instalador " msi" você poderá desinstalar o agent no gerenciador de programas do próprio windows ou então poderá seguir para a remoção via script ( uninstall ps1 ) presente na pasta do agent \# desinstalar o agent powershell exe executionpolicy bypass file c \programdata\65a\sphere agent\uninstall ps1 atmosphere o atmosphere é o módulo adicional que se conecta ao sphere agent instalado na máquina e fornece as ferramentas necessárias para execução de rotinas de automação / recuperação de processos e serviços compatibilidade de os o atmosphere funciona em todas as versões linux compatíveis com sphere agent para as versões windows há somente disponibilidade parcial de algumas distribuições requisitos para instalaçãoo espaço livre 500mb (mínimo recomendado) diretório de instalação /opt / atmosphere instalação automática o plugin de automação não deve ser instalado na instância masternode linux (64 bits) execute uma das opções de comando abaixo no terminal, a instalação será iniciada e exibirá o log do progresso no console \# (opção 1) utilizando curl curl k http //\<simon master node>/repo/install atmosphere sh | sudo sh \# (opção 2) utilizando wget wget o http //\<simon master node>/repo/install atmosphere sh | sudo sh após a instalação o simon irá detectar e exibir automaticamente em suas soluções que o módulo está disponível no item de configuração relacionado utilização de recursos do agent resource idle load disk 170mb cpu (single core) < 0,5% 3,5% max memory 32mb 50mb max network 0,5 kb/sec 10,9 kb/sec max