Active agent autoregistration，主动检查自动注册，将主动检查的 zabbix agent 主机自动添加到 zabbix server 中，无需手动配置。

关于自动注册

当 zabbix agent 为主动模式时，可以自动注册到 zabbix server 中，无需手动配置主机。

当 zabbix agent 为被动模式时，主机也可以自动发现，但是依旧需要借助主动检查（因为主动模式与被动模式可以并存）。

何时发生自动注册

自动注册发生在 未知 agent 请求检查条目时（在获取监控项时）：在主动检查中，zabbix agent 会向 zabbix server 请求获取监控项，此时会发生自动注册。

也就是说每次 zabbix agent 请求刷新监控项时，都会尝试触发自动注册。参数 RefreshActiveChecks 可以控制监控项的刷新频率，即可以间接控制自动注册频率。

在启动时 zabbix agent 会请求监控项，此时会立即触发自动注册。

自动注册流程

在主动检查时，zabxxi agent 会同时向 zabbix server 提供 ListenIP/ListenPort 参数（多个 IP 则只发送第一个）

然后 zabbix server 使用提供的 ListenIP/ListenPort 参数来注册 zabbix agent 主机。如果没有提供 ListenIP 则使用传入连接的地址；如果没有提供 ListenPort 则使用 10050（默认端口）。

自动注册需要哪些配置？

调整 zabbix agent 配置

修改 zabbix_agentd.conf 配置：

# 配置主动检查
ServerActive=10.0.0.1

#（可选）注意主机名重复问题
HostnameItem=system.hostname

然后，重启 zabbix agent 服务，以使配置生效。

用于 zabbix agent 自动注册的 Action

当 zabbix server 收到自动注册请求时，zabbix server 会调用 Action，事件源为 Auto registration 的 Action 必须被配置：

Using DNS as default interface

也可以指定 被自动注册的主机 应该使用 DNS name 作为默认的 Agent interface

需要在 zabbix agent 中配置 HostInterface 或 HostInterfaceItem 参数。（自从 Zabbix 4.4 开始支持）

注意事项，如果两个参数发生变化，主动注册主机的 Agent interface 将发生变化。因此，可以修改 Agent interface 为 其他 DNS 名称 或 网络地址。

过滤自动注册主机（Using host metadata）

在主动注册时，zabbix agent 将发送主机名，但是有时候我们需要更多信息来识别主机。

此时可以使用 HostMetadata / HostMetadataItem 参数。

在官方文档中，包含两个示例：（1）通过 HostMetadata 分别主机（Windows and Linux）；（2）通过 HostMetadata 过滤主机

自动注册的安全性（Secure autoregistration）

在 Administration => General => Autoregistration 中，可以设置 基于 PSK 认证 以提高自动注册的安全性。

触发重新自动注册（Autoregistration is rerun）

在某些场景下会发生“重新自动注册”；有时我们也需要重新自动注册，比如当我们为 Auto registration 的 Operations 加入新的模板（Link to templates）后，我们需要重新触发自动注册，以为全部自动注册主机添加模板。

以下场景会发生自动注册

1）如果主机 metadata 信息发生修改：
修改 HostMetadata 参数，并重启 agent 以使行配置生效，此时会发生自动注册；
由于 HostMetadataItem 动态取值，因此如果返回的数据发生变化，则会触发自动注册；

2）对于缺少元数据的手动创建的主机

3）如果主机被手动修改有 zabbix proxy 监控

4）如果 来自新的 zabbix proxy 的 相同主机名 自动注册

参考文献

Zabbix Documentation 4.4/2 Active agent autoregistration