VisĆ£o Geral do Sistema
Zones

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:

Antes de comeƧar, vamos entender a estrutura dos arquivos do agent:

Shell
ļ»æ

Arquivo de configuraĆ§Ć£o (atmosphere.yaml)

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
Document image
ļ»æ

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 atmosphere.yaml).

Modificar:

  • Hostname: Modificar para o IP do host;
  • Port: Modificar para a porta 80

Adicionar ao arquivo:

  • path: /sphere-sync
Document image
ļ»æ

Requisitos para instalaĆ§Ć£o

  • 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Ć³rios e DistribuiĆ§Ć£o

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ļ»æ

ļ»æ

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

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.

Shell
ļ»æ

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 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:

PowerShell
ļ»æ
ļ»æ

InstalaĆ§Ć£o Manual

Windows (64 bits):

  1. Salve o arquivo na pasta de serviƧos desejados, recomendamos a pasta: C:\ProgramData\65A
  2. Descompacte o arquivo baixado (se houver, escolha a opĆ§Ć£o "Extrair Aquiā€)
  3. Acesse a pasta criada e execute o arquivo no PowerShell:.\install-service.ps1
  4. Confirme no gerenciador de serviƧos do Windows se o processo ā€œsphere-agentā€ foi iniciado, caso contrĆ”rio, inicie o serviƧo.
  5. Reiniciar o serviƧo (apĆ³s modificar o config.yaml), no PowerShell: Restart-Service -Name "sphere-agent"

Linux (64 bits):

  1. 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ļ»æ
  2. Salve o arquivo na pasta de serviƧos desejados, recomendamos uma das pastas: /opt/ /srv/ /usr/src
  3. Descompacte o arquivo na pasta ou via comando no terminal: tar -zxvf sphere-agent-linux_x64.tar.gz
  4. Acesse a pasta criada e execute o comando no terminal:sudo bash ./install-service.sh
  5. Confirme o status do serviƧo rodando um dos comandos no terminal:sudo systemctl status sphere-agent
  6. 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

YAML
ļ»æ

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

Shell
ļ»æ

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:

PowerShell
ļ»æ

ļ»æ

ļ»æ

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Ć§Ć£o

  • EspaƧo livre: 500mb (mĆ­nimo recomendado)
  • DiretĆ³rio de InstalaĆ§Ć£o: /opt/.atmosphere
ļ»æ

InstalaĆ§Ć£o AutomĆ”tica

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.

Shell
ļ»æ

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.

ļ»æ

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

ļ»æ