Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

2 Zabbix Agent 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 Hostname

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 chave system.hostname sempre retornará o nome de NetBIOS limitado a 15 caracteres e sempre em CAIXA ALTA - independente do tamanho e dos caracteres minúsculos/maiúsculos no nome real do host.

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".

A chave system.hostname[host] sempre retornará o o nome completo e real (sensível ao caso) do servidor Windows.

Logo, para simplificar a configuração do arquivo zabbix_agentd.conf e unifica-lo, duas abordagens diferentes podem ser utilizadas.

  1. Deixe os parâmetros Hostname ou HostnameItem indefinidos para que o Zabbix Agent use o nome de NetBIOS como 'hostname';
  2. Deixe o parâmetro Hostname indefinido e defina o parâmetro HostnameItem de forma similar a esta:
    HostnameItem=system.hostname[host]
    e o Zabbix Agent irá utilizar o FQDN do servidor windows.

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.

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