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.
Para executar as verificações ativas em um host o Zabbix Agent precisa ter seu 'hostname' definido. Além disso o nome de host configurado no agente deverá ser exatamente igual ao nome “Nome de Host” configurado na interface web do Zabbix.
O valor do 'hostname' no lado do agente pode ser definido através do parâmetro Hostname ou HostnameItem em seu arquivo de configuração. Caso não sejam definidos serão utilizados os valores padrões.
O valor padrão para o parâmetro HostnameItem é o valor retornado pela chave “system.hostname” e na plataforma Windows ele irá retornar o nome de host NetBIOS.
O valor padrão para o parâmetro Hostname é o valor retornado pelo parâmetro HostnameItem. Logo, pra todos os efeitos, se os dois parâmetros não forem definidos o nome atual de NetBIOS será utilizado; O Zabbix Agent irá usar o nome de NetBIOS para solicitar a lista de verificações ativas do Zabbix Server e para enviar os resultados.
A partir do Zabbix agent 1.8.6 em ambiente Windows a chave “system.hostname” suporta um parâmetro opcional - type (tipo do nome). O valor padrão para este parâmetro é “netbios” (para compatibilidade retroativa) o outro valor possível é “host”.
Logo, para simplificar a configuração do arquivo zabbix_agentd.conf
e unifica-lo, duas abordagens diferentes podem ser utilizadas.
O nome de host também pode ser utilizado como parte do nome do serviço Windows e será utilizado para instalar, iniciar, parar e desinstalar o serviço. Por exemplo, se o arquivo de configuração define Hostname=Windows_db_server
, então o agente será instalado como o serviço Windows “Zabbix Agent [Windows_db_server]
”. Logo, para ter nomes de serviço diferentes para cada instância do Zabbix Agent, cada instância deverá ter um nome de host diferente.
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.
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
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
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