10 Microsoft Windows下的Zabbix agent 2

配置agent

从Zabbix5.0.4起，Zabbix agent 2以Windows服务运行.

您可以在Microsoft Windows主机上运行一个Zabbix agent 2实例或多个zabbix agent 2实例。 如果安装一个实例可以使用默认的配置文件C:\zabbix_agent2.conf或命令行中指定的配置文件。如果安装多个实例，每一个agent必须有自己的配置文件（其中一个实例可以使用默认配置文件）。

在Zabbix源文件目录有一个配置文件样例 conf/zabbix_agent2.win.conf。

关于配置Windows系统下的Zabbix agent 2的更多详细信息，请参阅配置文件选项。

Windows Zabbix agent不支持CPU在NUMA节点上非均匀分布的非标准Windows配置。 如果逻辑CPU的分布不均匀，那么某些CPU可能无法获得CPU性能指标。例如，如果有72个逻辑CPU和2个NUMA节点，那么两个节点都必须有36个cpu。

主机名参数

要在主机上执行 主动检查 Zabbix agent 2 需要定义主机名。 而且，agent端设置的主机名必须和前端配置的主机名 “主机名” 完全一致。

agent端的主机名可以通过配置文件的 Hostname 或 HostnameItem 参数定义-如果没有指定这些参数，则使用默认值。

HostnameItem参数的默认值，即agent端key的值为system.hostname返回的值，而对于Windows平台，它将返回NetBIOS主机名。

主机名 的默认值是HostnameItem参数的返回值。因此，实际上如果这两个参数都未指定，则实际的主机名将是主机NetBIOS名称;Zabbix agent 2将使用NetBIOS主机名从Zabbix服务器检索活动检查的列表，并将结果发送给它。

system.hostname 参数总是返回NetBIOS的主机名，该主机名限制在15个字符以内，并且只包含大写字母 - 不管实际主机名的长度和大小写字母。

system.hostname[host] 参数总是返回完整真实（区分大小写）的Windows主机名。

因此，为了简化zabbix_agent2.conf文件的配置并使其统一，可以使用两种不同的方法。

  1. 保留Hostname 或 HostnameItem 参数未定义，Zabbix agent 2将使用NetBIOS主机名作为主机名;

  2. 保留未定义的Hostname 参数并按如下方式定义 HostnameItem：
    HostnameItem=system.hostname[host]
    和 Zabbix agent 2 将使用完整真实的（区分大小写）Windows主机名作为主机名。

主机名还用作Windows服务名称的一部分，该Windows服务名称用于安装，启动，停止和卸载Windows服务。例如，如果Zabbix agent 2的配置文件指定Hostname=Windows_db_server，则该agent将被安装为Windows服务Zabbix Agent [Windows_db_server]。因此，要为每个Zabbix agent实例使用不同的Windows服务名，每个实例必须使用不同的主机名。

安装Windows agent服务

使用默认配置文件安装Zabbix agent 2的单个实例 c:\zabbix_agent2.conf:

  1. zabbix_agent2.exe --install

在64位系统上，所有与运行64位进程相关的检查都需要64位Zabbix agent版本才能正常工作。

如果您希望使用自定义的配置文件 c:\zabbix_agent2.conf, 则使用以下命令进行服务安装:

  1. zabbix_agent2.exe --config <your_configuration_file> --install

应指定配置文件的完整路径。

Zabbix agent 2 多实例启动方式，可使用如下命令进行安装服务:

  1.   zabbix_agent2.exe --config <configuration_file_for_instance_1> --install --multiple-agents
  2.   zabbix_agent2.exe --config <configuration_file_for_instance_2> --install --multiple-agents
  3.   ...
  4.   zabbix_agent2.exe --config <configuration_file_for_instance_N> --install --multiple-agents

已安装的服务应该在“控制面板”中可见.

启动agent

可以使用“控制面板”或执行命令行启动agent服务，。

使用默认配置文件启动Zabbix agent 2的单个实例:

  1.  zabbix_agent2.exe --start

使用自定义配置文件启动Zabbix agent 2单实例：

  1.  zabbix_agent2.exe --config <your_configuration_file> --start

启动Zabbix agent 2的多个实例之一:

  1.  zabbix_agent2.exe --config <configuration_file_for_this_instance> --start --multiple-agents

停止agent

您可以使用“控制面板”或从执行命令行停止agent服务。

停止使用默认配置文件启动的Zabbix agent 2 单实例，请执行如下操作：

  1.  zabbix_agent2.exe --stop

停止从自定义配置文件启动的Zabbix agent 2 单实例，请执行如下操作：

  1.  zabbix_agent2.exe --config <your_configuration_file> --stop

停止Zabbix agent 2 多个实例：

  1.  zabbix_agent2.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

卸载Windows agent服务

卸载使用默认配置文件的Zabbix agent 2单个实例：

  1.    zabbix_agent2.exe --uninstall

卸载使用非默认配置文件的Zabbix agent 2单个实例：

  1.    zabbix_agent2.exe --config <your_configuration_file> --uninstall

从Windows服务中卸载 Zabbix agent 2 多个实例：

  1.   zabbix_agent2.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents
  2.   zabbix_agent2.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents
  3.   ...
  4.   zabbix_agent2.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents