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

Funcionamento do agente

O Cloud Agent é instalado como um serviço no Windows, e pode ser iniciado/parado/reiniciado através da tabela de serviços (services.msc).

Serviço do Unit Platform Cloud Agent

O local de instalação fica em: C:\Program Files (x86)\Netwall\CloudAgent\. No arquivo var\CloudAgent.log estarão os logs de erro do agente. Em config\ ficam os arquivos de configuração.

Atualização automática

A partir da versão 6.0, 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 a tabela de serviços do Windows (services.msc):

Unit Platform Cloud Agent Update Service

As atualizações são habilitadas por padrão. Caso você deseje que o agente não atualize automaticamente, simplesmente pare o serviço de atualização e desabilite o serviço para que ele não inicie durante o boot (clique com o botão direito no nome do serviço, escolha propriedades e em altere o tipo de inicialização para desativado):

Desabilitando as atualizações

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 e serviços

O monitoramento de processos e serviços deve ser configurado manualmente nos arquivos config\process.conf e config\services.conf.

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 e da mesma forma que aparecem na aba “Detalhes” do Gerenciador de Tarefas do Windows. Veja o exemplo abaixo:

Configuração do monitoramento de processos

Para monitorar serviços do Windows, informe no arquivo services.conf os nomes dos serviços que devem ser monitorados um por linha. Atente para o fato que o nome do serviço que deve ser informado no arquivo é o que aparece em “Service name” nas propriedades do serviço:

Propriedades de um serviço do Windows

Exemplo de configuração de monitoramento de serviços:

Configuração do monitoramento de serviços

IMPORTANTE: após fazer as alterações nos arquivos process.conf e services.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.
  • Foi informado um intervalo de monitoramento/inventário inválido.

Se algum desses erros estiver ocorrendo, haverão mensagens de log em CloudAgent.log. Para corrigir esses erros, edite o arquivo agent.conf, siga as instruções nos comentários do arquivo e reinicie o agente. Em último caso, desinstale o agente e instale novamente.

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.