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