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.
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.
Antes de comeƧar, vamos entender a estrutura dos arquivos do agent:
Esta é a principal configuração que determina qual o servidor do AIOPS na rede e atributos essenciais do host como permissão de automação e configuração automÔtica do arquivo de coleta config.yaml.
Modificar:
- Hostname: Modificar para o IP do host;
- Port: Modificar para a porta 80
Adicionar ao arquivo:
- path: /sphere-sync
- scheme: http

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 atmosphere.yaml).
Modificar:
- Hostname: Modificar para o IP do host;
- Port: Modificar para a porta 80
Adicionar ao arquivo:
- path: /sphere-sync

- EspaƧo livre: 500mb (mĆnimo recomendado)
- Volume de instalação:
- Linux: /opt
- Sub-diretório: /sphere-agent-linux 
- Windows: C:/ProgramData/65A
- Sub-diretório: /sphere-agent-windows
Repositório Cloud AWS/S3: https://65a-internal-sa.s3-sa-east-1.amazonaws.com/repo/latest, este repositório é recomendado para obter a versão mais recente dos agents, sendo necessÔria a configuração manual dos arquivos (config.yaml e atmosphere.yaml).
Ambiente on-premise: utilize o formato de url http://<aiops-master-node>/repo

Procedimento recomendado e disponivel a partir da versão 3.0.0+.
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 AIOPS, 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.
Execute uma das opções de comando abaixo no terminal, a instalação serÔ iniciada e exibirÔ o log do progresso no console.
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.
Faça o download do arquivo no repositório do AIOPS através da url como no exemplo: http://<aiops-master-node>/repo/update-sphere-agent.ps1
Execute o PowerShell como Administrador e rode o comando abaixo:
- 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
- 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"
- 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
- 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
Com este arquivo presente na pasta de configuração serĆ” possĆvel controlar as configuraƧƵes do agent remotamente (via Atmos).
Aviso: Cuidado ao utilizar o comando "rm -rf ***" apontando somente as pastas do agent informadas acima.
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:

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.
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.
- EspaƧo livre: 500mb (mĆnimo recomendado)
- Diretório de Instalação: /opt/.atmosphere
Execute uma das opções de comando abaixo no terminal, a instalação serÔ iniciada e exibirÔ o log do progresso no console.
Após a instalação o AIOPS irĆ” detectar e exibir automaticamente em suas soluƧƵes que o módulo estĆ” disponĆvel no Item de Configuração relacionado.
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 |