2 Agente Zabbix no Microsoft Windows

Configurando o agente

O agente Zabbix roda como um serviço Windows.

Pode-se rodar uma ou múltiplas instancias de um agente Zabbix em um host Windows. Uma instância única pode usar o arquivo de configuração padrão C:\zabbix_agentd.conf ou um outro, especificado na linha de comando. Para o caso de múltiplas instâncias, cada agente deve ter seu próprio arquivo de configuração, mas uma pode usar o padrão.

Um exemplo de arquivo de configuração está disponível no pacote de fontes do Zabbix em conf/zabbix_agentd.win.conf.

Veja as opções no arquivo de configuração para detalhes sobre configuração do agente Zabbix em Windows.

Parâmetro hostname

Para realizar active checks em um host o agente Zabbix precisa ter o hostname definido. Além disso, o hostname no agente deve ser exatamente igual ao "Host name" configurado para o host no frontend.

O valor para o hostname no agente pode ser definido com os parâmetros Hostname ou HostnameItem no arquivo de configuração - ou os valores padrão seráo usados se nenhum destes parâmetros estiver definido.

O valor padrão para o parâmetro HostnameItem é aquele retornado pela chave "system.hostname" do agente e, para Windows, ele é o hostname NetBIOS.

O valor padrão para o Hostname é o valor retornado pelo parâmetro HostnameItem. Assim, na prática, se nenhum destes parâmetros for especificado o hostname real será o nome NetBIOS do host. O agente Zabbix vai usar o nome NetBIOS para recuperar a lista de active checks do servidor Zabbix e enviar resultados para ele.

A chave system.hostname sempre retorna o nome NetBIOS do host, que é limitado a 15 símbolos e em MAIÚSCULAS - independente do tamanho e caixa dos caracteres no hostname real.

A partir da versão 1.8.6 do agente Zabbix para 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) e outro valor possível é "host".

A chave system.hostname[host] sempre retorna o hostname Windows completo e real (sensível à caixa).

Assim, para simplificar a configuração do arquivo zabbix_agentd.conf e torná-la unificada, duas abordagens podem ser usadas.

  1. Deixar os parâmetros Hostname e HostnameItem indefinidos, fazendo o agente Zabbix usar o hostname NetBIOS como hostname;
  2. Deixar o parâmetro Hostname indefinido e definir HostnameItem desta forma:
    HostnameItem=system.hostname[host]
    fazendo o agente Zabbix usar o hostname Windows completo e real (sensível à caixa) como hostname.

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

Instalando o agente como um serviço Windows

Para instalar uma instância única de um agente Zabbix com o arquivo de configuração padrão c:\zabbix_agentd.conf:

zabbix_agentd.exe --install

Em um sistema 64 bits, um versão 64 bits do agente Zabbix é necessária para todas as verificações relacionadas a processos 64 bits funcionarem corretamente.

Se for desejado usar um arquivo de configuração que não c:\zabbix_agentd.conf, deve-se usar o seguinte comando para instalação do serviço:

zabbix_agentd.exe --config <seu-arquivo-de-configuração> --install

Um caminho completo para o arquivo de configuração deve ser especificado.

Múltiplas instâncias de um agente Zabbix podem ser instaladas como serviços da seguinte forma:

  zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-1> --install --multiple-agents
         zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-2> --install --multiple-agents
         ...
         zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-N> --install --multiple-agents

O serviço instalado deve estar vísivel, então, no Painel de Controle.

Iniciando o agente

Pode-se iniciar o serviço agente via Painel de Controle ou linha de comando.

Para iniciar uma única instância de agente Zabbix com o arquivo de configuração padrão:

 zabbix_agentd.exe --start

Para iniciar uma única instância de um agente Zabbix com outro arquivo de configuração:

 zabbix_agentd.exe --config <seu-arquivo-de-configuração> --start

Para iniciar uma ou múltiplas instâncias de um agente Zabbix:

 zabbix_agentd.exe --config <arquivo-de-configuração-para-esta-instância> --start --multiple-agents

Parando o agente

Pode-se parar o serviço agente via Painel de Controle ou linha de comando.

Para parar uma única instância do agente Zabbix iniciada com o arquivo de configuração padrão:

 zabbix_agentd.exe --stop

Para parar uma única instância do agente Zabbix iniciada com outro arquivo de configuração:

 zabbix_agentd.exe --config <seu-arquivo-de-configuração> --stop

Para parar uma ou múltiplas instâncias de um agente Zabbix:

 zabbix_agentd.exe --config <arquivo-de-configuração-para-esta-instância> --stop --multiple-agents

Desinstalando um serviço agente

Para desinstalar uma única instância de um agente Zabbix usando o arquivo de configuração padrão:

   zabbix_agentd.exe --uninstall

Para desinstalar uma única instância de um agente Zabbix usando um arquivo de configuração não padrão:

   zabbix_agentd.exe --config <seu-arquivo-de-configuração> --uninstall

Para deinstalar múltiplas instâncias de serviços agentes Zabbix:

  zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-1> --uninstall --multiple-agents
         zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-2> --uninstall --multiple-agents
         ...
         zabbix_agentd.exe --config <arquivo-de-configuração-da-instância-N> --uninstall --multiple-agents