10 Agente Zabbix no Microsoft Windows

Configurando o agente

O Zabbix Agent é executado como um serviço do Windows.

Você pode executar uma instância simples do Zabbix Agent ou múltiplas instâncias em um host Windows. Uma instância simples pode utilizar o arquivo de configuração em seu local padrão: C:\zabbix_agentd.conf ou outra localização especificada na linha de comando. Para o caso de múltiplas instâncias, cada instância do agente deverá ter seu próprio arquivo de configuração (uma das instâncias pode usar o arquivo padrão).

Junto com o código fonte do Zabbix é fornecido um exemplo de arquivo de configuração no diretório conf/zabbix_agentd.win.conf.

Consulte o manual de configuração do agente no windows para opções e detalhes de configuração neste sistema operacional.

Parâmetro do nome do host

Para executar verificações ativas em um host O agente Zabbix precisa ter o nome do host definido. Além disso, o nome do host valor definido no lado do agente deve corresponder exatamente ao "Host name" configurado para o host no a parte dianteira.

O valor do nome do host no lado do agente pode ser definido pelo Hostname ou parâmetro HostnameItem no agente configuration file - ou os valores padrão são usados se algum desses parâmetros não for especificado.

O valor padrão para o parâmetro HostnameItem é o valor retornado pela chave do agente "system.hostname". Para Windows, ele retorna o resultado da função gethostname(), que consulta os provedores de namespace para determinar o nome do host local. Se nenhum provedor de namespace responder, o nome NetBIOS será retornado.

O valor padrão para Hostname é o valor retornado pelo Parâmetro HostnameItem. Então, com efeito, se ambos os parâmetros são não especificado, o nome do host real será o nome NetBIOS do host; Zabbix agente usará o nome do host NetBIOS para recuperar a lista de verificações ativas do servidor Zabbix e enviar os resultados para ele.

O valor padrão para Hostname é o valor retornado pelo Parâmetro HostnameItem. Então, com efeito, se ambos os parâmetros são não especificado, o nome do host real será o nome NetBIOS do host; Zabbix agente usará o nome do host NetBIOS para recuperar a lista de verificações ativas do servidor Zabbix e enviar os resultados para ele.

A chave "system.hostname" suporta dois parâmetros opcionais - type e transformar.

O parâmetro Type determina o tipo de nome que o item deve retornar. Valores suportados:

• netbios (padrão) - retorna o nome do host NetBIOS que é limitado a 15 símbolos e está apenas em MAIÚSCULAS;
• host - diferencia maiúsculas de minúsculas, retorna o nome completo e real do host do Windows (sem um domínio);
• shorthost (suportado desde o Zabbix 5.4.7) - retorna parte do hostname antes do primeiro ponto. Ele retornará uma string completa se o nome não contém um ponto.

O parâmetro Transform é suportado desde o Zabbix 5.4.7 e permite especifique uma regra de transformação adicional para o nome do host. Compatível valores:

• nenhum (padrão) - use a letra maiúscula original;
• lower - converte o texto em minúsculas.

Então, para simplificar a configuração do arquivo zabbix_agentd.conf e fazer unificado, duas abordagens diferentes poderiam ser usadas.

1. deixe os parâmetros Hostname ou HostnameItem indefinidos e O agente Zabbix usará o nome do host NetBIOS como o nome do host;
2. deixe o parâmetro Hostname indefinido e defina HostnameItem assim:
   HostnameItem=system.hostname[host] - para o agente Zabbix usar o nome de host completo e real (diferencia maiúsculas de minúsculas) do Windows como o nome do host
   HostnameItem=system.hostname[shorthost,lower] - para Zabbix agente use apenas parte do nome do host antes do primeiro ponto, convertidos em minúsculas.

O nome do host também é usado como parte do nome do serviço do Windows, que é usado para instalar, iniciar, parar e desinstalar o serviço do Windows. Para exemplo, se o arquivo de configuração do agente Zabbix especificar Hostname=Windows_db_server, então o agente será instalado como um Serviço do Windows "Zabbix Agent [Windows_db_server]". Portanto, ter um nome de serviço do Windows diferente para cada instância do agente Zabbix, cada instância deve usar um nome de host diferente.

Instalando o agente como um serviço Windows

Para instalar uma instância simples do agente usando o arquivo padrão de configuração c:\zabbix_agentd.conf:

zabbix_agentd.exe --install

Se você quiser utilizar outro arquivo de configuração que não o padrão (c:\zabbix_agentd.conf), você poderá definir a sua localização durante a instalação do serviço:

zabbix_agentd.exe --config <your_configuration_file> --install

O caminho completo para o arquivo de configuração deverá ser fornecido.

Múltiplas instâncias do Zabbix Agent podem ser instaladas como serviços conforme exemplo abaixo:

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents
         zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents
         ...
         zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents

Os serviços instalados deverão estar visíveis através do panel de controle.

Iniciando o agente

Para iniciar o serviço do agente você pode usar o painel de controle ou faze-lo a partir da linha de comando.

Iniciar uma instância simples do Zabbix Agent com arquivo padrão de configuração:

zabbix_agentd.exe --start

Iniciar uma instância simples do Zabbix Agent com arquivo de configuração específico:

zabbix_agentd.exe --config <your_configuration_file> --start

Iniciar múltiplas instâncias do Zabbix Agent com arquivo de configuração específicos:

zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents

Parando o agente

Para parar o serviço do agente você pode usar o painel de controle ou faze-lo a partir da linha de comando.

Parar uma instância simples do Zabbix Agent com arquivo padrão de configuração:

zabbix_agentd.exe --stop

Parar uma instância simples do Zabbix Agent com arquivo de configuração específico:

zabbix_agentd.exe --config <your_configuration_file> --stop

Parar múltiplas instâncias do Zabbix Agent com arquivo de configuração específicos:

zabbix_agentd.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

Desinstalar o serviço do agente

Para desinstalar uma instância simples do Zabbix Agent com arquivo padrão de configuração:

zabbix_agentd.exe --uninstall

Para desinstalar uma instância simples do Zabbix Agent com arquivo de configuração específico:

zabbix_agentd.exe --config <your_configuration_file> --uninstall

Para desinstalar múltiplas instâncias do Zabbix Agent com arquivo de configuração específicos:

zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents

Limitations

Zabbix agent for Windows does not support non-standard Windows configurations where CPUs are distributed non-uniformly across NUMA nodes. If logical CPUs are distributed non-uniformly, then CPU performance metrics may not be available for some CPUs. For example, if there are 72 logical CPUs with 2 NUMA nodes, both nodes must have 36 CPUs each.