Documentation
Table of Contents
10 Zabbix agent 在 Microsoft Windows 上
配置 agent
作为Windows服务的两代Zabbix agents run。对于Zabbix agent 2，在下方说明中将 agentd 替换为 agent2。
您可以 run 一个 Zabbix agent 实例或多个实例 Microsoft Windows 主机上的agent。单个实例可以使用以下任一方式：
- 默认配置文件，位于相同目录中 目录作为agent二进制文件；
- 在命令行中指定的配置 file。
在存在多个实例的情况下，每个 agent 实例都必须拥有其自己的 配置 file（其中一个实例可以使用默认配置文件）。
一个示例配置 file 在 Zabbix 源代码归档中如下所示：
conf/zabbix_agentd.conf用于 Zabbix agent；conf/zabbix_agent2.conf用于 Zabbix agent2。
如果你想将 Zabbix agent/agent 2 作为服务安装在 Windows 上，从 archive 未指定 配置 file，然后在安装 agent 之前：
conf/zabbix_agentd.conf应手动复制到目录中 zabbix_agentd.exe 将会被安装；conf/zabbix_agent2.conf和conf/zabbix_agent2.d目录应为 手动复制到将安装 zabbix_agent2.exe 的目录中。
请参阅 configuration file 有关配置 Zabbix Windows agent 的选项，请参见详细信息。
主机名参数
执行 主动检查 操作 一个主机 Zabbix agent 需要定义主机名。此外，该主机名 value set on the agent side should exactly match the "Host name" configured for 主机 in the 前端。
主机名值在 agent 侧可以通过以下方式定义： Hostname 或 HostnameItem 参数在 agent configuration file 中 — 或默认值 如果未指定这些参数中的任何一个，则使用它们。
HostnameItem 参数的默认值为返回的值 通过 "system.hostname" agent 键。对于 Windows 系统，它返回 gethostname() 函数的结果，该结果由 queries 命名空间提供程序用来确定本地 主机名。如果没有命名空间提供程序响应，则返回 NetBIOS 名称。
Hostname 的默认值是由以下命令返回的值： HostnameItem 参数。因此，实际上，如果这两个参数都满足 未指定，实际主机名将为 主机 NetBIOS 名称；Zabbix agent 将使用 NetBIOS 主机名 来检索主动检测列表 从 Zabbix server 接收数据并将其结果发送给它。
"system.hostname"键支持两个可选参数 - 类型 和 转换。
类型 确定 监控项 应该返回的名称类型：
- netbios（默认）- 返回 NetBIOS 主机名，其限制为 15 个符号，且仅包含大写字母；
- 主机 - 区分大小写，返回完整的、真实的 Windows 主机名（不带域名）；
- shorthost - 返回主机名中第一个点之前的部分。 如果名称不包含点，则它将返回一个完整的string。
- fqdn - 返回完全限定域名（不带尾随点）。
Transform 允许为主机名指定额外的转换规则：
- none (默认) - 使用原始字母大小写；
- lower - 将文本转换为小写。
因此，为了简化 zabbix_agentd.conf file 的配置并使其更易于管理， 它统一了三种不同的方法：
1。将 Hostname 或 HostnameItem 参数留空，并 Zabbix agent 将使用 NetBIOS 主机名 作为主机名。 2。将 Hostname 参数留空，并定义 HostnameItem 仅返回OutputFormat格式要求结果 HostnameItem=system.hostname[主机] - 用于 Zabbix agent 使用 作为主机名的完整、真实的（区分大小写）Windows 主机名 HostnameItem=system.hostname[shorthost,lower] - 用于 Zabbix agent 使用主机名第一个点之前的部分 转换为小写。 HostnameItem=system.hostname[fqdn] - 用于让 Zabbix agent 使用完全限定域名作为主机名。
主机名 也用作 Windows 服务名称的一部分，该名称用于 安装、启动、停止和卸载 Windows 服务。对于 例如，如果 Zabbix agent 配置 file 指定 Hostname=Windows_db_server，然后将作为agent安装 Windows服务"Zabbix Agent [Windows_db_server]"。因此，要使 每个 Zabbix agent 实例使用不同的 Windows 服务名称，每个 实例必须使用不同的 主机名。
将 agent 安装为 Windows 服务
在安装agent之前，需手动copyconf/zabbix_agentd.conf至 安装zabbix_agentd.exe的目标目录。
安装单实例Zabbix agent（使用默认配置） 配置 file：
在64位系统上，一个64位的Zabbix agentversion 是确保所有与运行64位进程相关的检查正常工作的必要条件 正确。
如果您希望使用默认配置file以外的其他配置， 应使用以下命令进行服务安装：
应指定file配置文件的完整路径。
可以安装多个Zabbix agent实例作为服务 这个
zabbix_agentd.exe --config <实例1的配置文件> --install --multiple-agents
zabbix_agentd.exe --config <实例2的配置文件> --install --multiple-agents
...
zabbix_agentd.exe --config <instance_N的配置文件> --install --multiple-agents安装的服务现在应能在控制面板中可见。
Starting agent
要启动 agent 服务，可以使用控制面板或从命令行启动。
启动使用默认配置文件的单个 Zabbix agent 实例：
启动使用其他配置文件的单个 Zabbix agent 实例：
启动多个 Zabbix agent 实例中的一个：
停止 agent
要停止 agent 服务，可以使用控制面板或通过命令行操作。
要停止使用默认配置文件启动的单个 Zabbix agent 实例：
要停止使用其他配置文件启动的单个 Zabbix agent 实例：
要停止多个 Zabbix agent 实例中的一个：
卸载 agent Windows 服务
使用默认配置文件卸载单个 Zabbix agent 实例：
使用非默认配置文件卸载单个 Zabbix agent 实例：
从 Windows 服务中卸载多个 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 agent 不支持非标准的 Windows 配置，其中 CPU 在 NUMA 节点之间非均匀分布。如果逻辑 CPU 非均匀分布，则某些 CPU 的性能指标可能不可用。例如，如果有 72 个逻辑 CPU 和 2 个 NUMA 节点，则每个节点必须都有 36 个 CPU。