10 在Microsoft Windows上的 Zabbix agent

配置 agent

两代Zabbix agent都是做为 Windows 服务运行的。对于 Zabbix agent 2，请在下面的说明中将 agentd 替换为 agent2 。

您可以在 Microsoft Windows 主机上运行 Zabbix agent的单个实例或多个实例。单个实例可以使用默认配置文件 C:\zabbix_agentd.conf或在命令行中指定的配置文件。在多个实例的情况下，每个代理实例都必须有自己的配置文件（其中一个实例可以使用默认配置文件）。

在Zabbix源码包中提供了一个示例配置文件，如下 conf/zabbix_agentd.win.conf.

有关配置 Zabbix Windows agent的详细信息的选项，另见 配置文件。

主机名参数

要在主机上执行主动检查，Zabbix agent 需要定义主机名。此外，agent 端设置的主机名值应与前端为主机配置的"Host name"完全匹配。

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

HostnameItem参数的默认值是由"system.hostname" agent 键返回的值。对于Windows，它返回gethostname()函数的结果，该函数查询名称空间提供程序以确定本地主机名。如果没有名称空间提供程序响应，则返回NetBIOS名称。

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

"system.hostname"键支持两个可选参数 - type和transform。

Type参数确定项目应返回的名称类型。支持的值：

• netbios（默认） - 返回NetBIOS主机名，该名称限制为15个符号，并且仅是大写字母；
• host - 区分大小写，返回完整的真实Windows主机名（不包括域）；
• shorthost（自Zabbix 5.4.7起支持） - 返回第一个点之前的主机名部分。如果名称不包含点，则返回完整字符串。

Transform参数自Zabbix 5.4.7起支持，并允许为主机名指定额外的转换规则。支持的值：

• none（默认） - 使用原始字母大小写；
• lower - 将文本转换为小写。

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

1. 保留Hostname或HostnameItem参数未定义，Zabbix agent 将使用NetBIOS主机名作为主机名；
2. 保留Hostname参数未定义，并这样定义HostnameItem： HostnameItem=system.hostname[host] - 让Zabbix agent 使用完整的真实（区分大小写）Windows主机名作为主机名 HostnameItem=system.hostname[shorthost,lower] - 让Zabbix agent 只使用主机名的第一个点之前的部分，并转换为小写。

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

安装 agent 并注册 Windows 服务

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

zabbix_agentd.exe --install

如果您希望使用除c:\zabbix_agentd.conf以外的配置, 您应该使用以下命令进行服务安装:

zabbix_agentd.exe --config <your_configuration_file> --install

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

Zabbix agent的多个实例可以这样安装服务:

  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

安装的服务现在应该在"控制面板"中可见。

Starting agent

要启动agent服务，可以使用"控制面板"或从命令行执行此操作

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

 zabbix_agentd.exe --start

指定配置文件启动单个实例的 Zabbix agent:

 zabbix_agentd.exe --config <your_configuration_file> --start

启动多个Zabbix agent实例的其中一个，请执行以下操作：

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents

停止 agent

要停止agent服务，可以使用"控制面板"或从命令行执行此操作.

使用默认配置文件停止单个实例的 Zabbix agent:

 zabbix_agentd.exe --stop
        

指定配置文件停止单个实例的 Zabbix agent:

 zabbix_agentd.exe --config <your_configuration_file> --stop

停止多个Zabbix agent实例的其中一个，请执行以下操作:

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

卸载Windows 服务上的 zabbix agent

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

   zabbix_agentd.exe --uninstall

指定配置文件卸载单个实例的 Zabbix agent:

   zabbix_agentd.exe --config <your_configuration_file> --uninstall

卸载多个Zabbix agent实例，请执行以下操作:

  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

局限性

用于 Windows 的 Zabbix 代理不支持非标准的 Windows 配置，cpu 在 NUMA 节点上非均匀分布。如果逻辑 CPU 是非均匀分布的，那么某些 CPU 的 CPU 性能指标可能不可用。 例如, 如果有72个逻辑CPU分布在2个NUMA节点，那么每个节点必须有36个CPU。