Microsoft Windows 上的 Zabbix agent
配置 agent
Zabbix 两代 agent 都作为 Windows 服务运行。对于 Zabbix agent 2，请在下面的说明中将 agentd 替换为 agent2。
您可以在 Microsoft Windows 主机上运行一个 Zabbix agent 实例，或者运行多个 agent 实例。单个实例可以使用以下任一方式：
- 默认配置文件，位于与 agent 二进制文件相同的目录中；
- 在命令行中指定的配置文件。
如果运行多个实例，则每个 agent 实例都必须有自己的配置文件（其中一个实例可以使用默认配置文件）。
示例配置文件可在 Zabbix 源代码归档中找到，路径如下：
conf/zabbix_agentd.conf，适用于 Zabbix agent；conf/zabbix_agent2.conf，适用于 Zabbix agent2。
如果您希望从 归档 中将 Zabbix agent/agent 2 作为 Windows 服务安装，而不显式指定配置文件，那么在安装 agent 之前：
- 应手动将
conf/zabbix_agentd.conf复制到将安装 zabbix_agentd.exe 的目录中； - 应手动将
conf/zabbix_agent2.conf和conf/zabbix_agent2.d目录复制到将安装 zabbix_agent2.exe 的目录中。
有关配置 Zabbix Windows agent 的详细信息，请参见 配置文件 选项。
主机名参数
要在主机上执行 active checks，Zabbix agent 需要定义主机名。此外，agent 端设置的主机名值应与在前端为该主机配置的 "主机名" 完全一致。
agent 端的主机名值可以通过 agent 配置文件 中的 Hostname 或 HostnameItem 参数来定义；如果未指定这些参数中的任何一个，则会使用默认值。
HostnameItem 参数的默认值是 "system.hostname" agent key 返回的值。对于 Windows，它返回 gethostname() 函数的结果，该函数会查询命名空间提供程序以确定本地主机名。如果没有命名空间提供程序响应，则返回 NetBIOS 名称。
Hostname 的默认值是 HostnameItem 参数返回的值。因此，实际上，如果这两个参数都未指定，实际主机名将是主机的 NetBIOS 名称；Zabbix agent 将使用 NetBIOS 主机名从 Zabbix 服务器获取 active checks 列表，并将结果发送给它。
"system.hostname" key 支持两个可选参数 - type 和 transform。
Type 用于确定监控项应返回的名称类型：
- netbios（默认）- 返回 NetBIOS 主机名，长度限制为 15 个字符，且仅为大写；
- host - 区分大小写，返回完整的、真实的 Windows 主机名（不含域）；
- shorthost - 返回主机名中第一个点号之前的部分。 如果名称不包含点号，则返回完整字符串。
- fqdn - 返回完全限定域名（不含末尾的点）。
Transform 允许为主机名指定额外的转换规则：
- none（默认）- 使用原始字母大小写；
- lower - 将文本转换为小写。
因此，为了简化 zabbix_agentd.conf 文件的配置并使其统一，可以使用以下三种不同的方法：
- 不定义 Hostname 或 HostnameItem 参数，Zabbix agent 将使用 NetBIOS 主机名作为主机名。
- 不定义 Hostname 参数，并按如下方式定义 HostnameItem：
HostnameItem=system.hostname[host] - 使 Zabbix agent 使用完整的、真实的（区分大小写的）Windows 主机名作为主机名。
HostnameItem=system.hostname[shorthost,lower] - 使 Zabbix agent 仅使用主机名中第一个点号之前的部分，并转换为小写。
HostnameItem=system.hostname[fqdn] - 使 Zabbix agent 使用完全限定域名作为主机名。
主机名还会作为 Windows 服务名称的一部分，用于安装、启动、停止和卸载 Windows 服务。例如，如果 Zabbix agent 配置文件指定 Hostname=Windows_db_server，那么该 agent 将作为 Windows 服务 "Zabbix Agent [Windows_db_server]" 安装。因此，要为每个 Zabbix agent 实例使用不同的 Windows 服务名称，每个实例必须使用不同的主机名。
将 agent 安装为 Windows 服务
在安装 agent 之前，请先将 conf/zabbix_agentd.conf 手动复制到 zabbix_agentd.exe 将要安装的目录中。
要使用默认配置文件安装单个 Zabbix agent 实例：
zabbix_agentd.exe --install在 64 位系统上，所有与运行 64 位进程相关的检查要正常工作，都需要使用 64 位版本的 Zabbix agent。
如果您希望使用默认配置文件以外的其他配置文件，则应使用以下命令安装服务：
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现在，已安装的服务应可在控制面板中看到。
启动 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卸载 agent Windows 服务
要使用默认配置文件卸载单个 Zabbix agent 实例：
zabbix_agentd.exe --uninstall要使用非默认配置文件卸载单个 Zabbix agent 实例：
zabbix_agentd.exe --config <your_configuration_file> --uninstall要从 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 不支持 CPU 在 NUMA 节点之间非均匀分布的非标准 Windows 配置。如果逻辑 CPU 的分布 不均匀，则某些 CPU 可能无法获取 CPU 性能指标。例如，如果有 72 个逻辑 CPU 和 2 个 NUMA 节点， 则两个节点都必须各有 36 个 CPU。