Configuração avançada do Unit Platform Cloud Agent (Linux)

Funcionamento do agente

O Cloud Agent é instalado como um serviço, e pode ser iniciado/parado/reiniciado através do init script.

A partir da versão 6.1 do Cloud Agent:

# parando o agente
/etc/init.d/unit-platform-cloud-agent stop

# iniciando o agente 
/etc/init.d/unit-platform-cloud-agent start 

# reiniciando o agente 
/etc/init.d/unit-platform-cloud-agent restart

Para versões anteriores:

# parando o agente
/etc/init.d/unit_cloud_agent stop

# iniciando o agente
/etc/init.d/unit_cloud_agent start

# reiniciando o agente
/etc/init.d/unit_cloud_agent restart

Para verificar se o agente está rodando, execute:

Para o Cloud Agent versão 6.1+:

/etc/init.d/unit-platform-cloud-agent status

Para versões anteriores:

/etc/init.d/unit_cloud_agent status

O local de instalação fica em: /opt/Netwall/CloudAgent/. O diretório config/ armazena os arquivos de configuração.

Para a versão  6.1+ os arquivos de log ficam armazenados no diretório  /var/log/unit-platform-cloud-agent/. Nas versões anteriores os logs ficam em /var/log/unit_cloud_agent.log.

Atualização automática

A partir da versão 6.1, o Unit Platform Cloud Agent possui um serviço adicional que é responsável por atualizar os arquivos do agente. Os updates são baixados direto da Unit Platform.

O serviço de atualização pode ser gerenciado usando os seguintes comandos:

# parando o serviço de atualização
/etc/init.d/unit-platform-cloud-agent-update stop 

# iniciando o serviço de atualização
/etc/init.d/unit-platform-cloud-agent-update start 

# reiniciando o serviço de atualização 
/etc/init.d/unit-platform-cloud-agent-update restart

# verificando o status do serviço de atualização 
/etc/init.d/unit-platform-cloud-agent-update status

As atualizações são habilitadas por padrão. Se você não deseja que o agente atualize automaticamente, simplesmente pare o serviço de atualização, e configure o serviço para não iniciar durante o boot usando o comando chkconfig unit-platform-cloud-agent-update off ou update-rc.d unit-platform-cloud-agent-update disable dependendo da sua distro.

Personalização da configuração

A configuração geral do agente é especificada no arquivo config/agent.conf. Nesse arquivo é permitido alterar os seguintes itens:

  • Habilitar/desabilitar o envio de informações de monitoramento.
  • Habilitar/desabilitar o envio de informações de inventário.
  • Alterar o intervalo de envio de informações de monitoramento e inventário para a Unit Platform.
  • Alterar a chave da empresa.
  • Alterar o endereço para o qual as informações de monitoramento devem ser enviadas. Por padrão: app.unitplatform.io. Apenas altere este campo se você estiver usando a Unit Platform on-premises.
  • Configurar o tempo de timeout para a execução dos comandos de coleta de dados.
  • Habilitar/desabilitar a exibição de mensagens de debug no arquivo de log do agente.

IMPORTANTE: após fazer alterações nos arquivo agent.conf, reinicie o serviço do agente para que as alterações entrem em efeito.

Monitoramento de processos

Para monitoramento de processos, informe no arquivo process.conf os nomes dos processos que devem ser monitorados. Os nomes devem ser preenchidos um por linha. Veja o exemplo abaixo:

httpd
sshd
mysqld

Os processos são monitorados através do comando ps -C "[proc]" certifique-se que o nome do seu processo aparece corretamente na saída desse comando.

IMPORTANTE: após fazer as alterações no arquivo process.conf, reinicie o serviço do agente para que as alterações entrem em efeito.

Resolução de problemas

Abaixo estão listados os problemas mais comuns que podem impedir o envio de informações do dispositivo para a Unit Platform:

O dispositivo não possui acesso à internet

É necessário que o dispositivo tenha permissões para trafegar dados via HTTPS para o endereço https://app.unitplatform.io/.  Revise as regras de firewall que possivelmente estejam impedindo o dispositivo de acessar a internet.

O serviço do agente não está rodando

O serviço do agente está configurado para parar automaticamente caso os seguintes erros de configuração ocorram:

  • A chave da empresa não foi informada ou é inválida.

Para corrigir este erro, edite o arquivo agent.conf e informe a chave correta na variável “key”.

  • Foi informado um intervalo de monitoramento/inventário inválido.

Para corrigir esse erro, edite o arquivo agent.conf e revise os valores informados nos intervalos.

  • O agente foi instalado em uma distribuição não homologada.

Verifique se a sua distribuição está na lista de sistemas operacionais homologados, se estiver contate-nos através do link “Suporte” no menu acima.

  • Algum pré-requisito não foi instalado corretamente.

Revise se todos os pré-requisitos foram instalados corretamente. Caso o erro persista após a verificação dos requisitos, execute o comando ldd para verificar se há alguma dependência não mapeada:

ldd /opt/Netwall/CloudAgent/bin/UnitPlatformCloudAgent_x64

Caso alguma lib esteja com o status “not found”, contate-nos através do link “Suporte” no menu acima.

O limite de dispositivos contratados no plano foi excedido

Neste caso, revise a sua configuração de assinatura da Unit Platform e reinicie o agente.