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.
- deixe os parâmetros Hostname ou HostnameItem indefinidos e O agente Zabbix usará o nome do host NetBIOS como o nome do host;
- 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
Em ambientes de 64-bit, uma versão de 64-bit do Zabbix Agent será necessária para que todas as verificações relacionadas a proesssos em 64-bits funcione adequadamente.
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.