Zabbix agent 2是新一代的Zabbix agent,可以替代Zabbix agent使用。 Zabbix agent 2 已开发为:
Agent 2 是用Go 语言编写(复用了一些 Zabbix agent 中的C 语言代码).。在构建Zabbix agent 2 时,需要配置当前支持的Go环境 Go version 。
Agent 2 在Linux上没有内置的守护进程支持; 它可以作为 Windows service.
被动检查的工作类似于Zabbix agent。主动检查支持 调度/灵活间隔 同时并发检查仅使用一个active server.
默认情况下,Zabbix agent2将在监控项更新间隔内以条件随机时间调度主动检查的第一次数据采集,避免资源使用率突增。为了在agent重启后立即做好非调度采集间隔 的主动检查,设置配置文件中ForceActiveChecksOnStart参数(全局)或者Plugins.<Plugin name>.System.ForceActiveChecksOnStart(仅影响特定插件)。插件级别参数会覆盖全局参数。从Zabbix6.0.2版本开始,支持启动agent时强制执行主动检查。
检查并发
来自不同插件的检查可以同时执行。一个插件的并发检查次数受插件容量设置的限制。每个插件都可以有一个硬编码的容量设置(默认为100),可以使用 Plugins.<Plugin name>.Capacity=N
设置 Plugins 配置 parameter.
参考: Plugin development guidelines.
以下平台支持 Zabbix agent 2:
Zabbix agent 2 在预编译的 Zabbix 包中可用。要从 源码 编译 Zabbix agent 2,您必须指定 --enable-agent2
配置选项。
Zabbix agent 2 可以使用以下命令行参数 :
参数 | 描述 |
---|---|
-c --config <config-file> | 配置文件的路径。 您可以使用此选项指定非默认的配置文件。 在 UNIX, 默认是 /usr/local/etc/zabbix_agent2.conf 或者编译时设置 compile-time 变量--sysconfdir or --prefix |
-f --foreground | 在前台运行Zabbix agent (默认: true). |
-p --print | 打印已知监控项并退出。 注意: 也返回 用户参数结果 , 必须指定配置文件(如果它不在默认位置)。 |
-t --test <item key> | 测试指定监控项并退出。 注意: 也返回 用户参数 结果, 必须指定配置文件 (如果它不在默认位置)。 |
-h --help | 打印帮助信息并退出。 |
-v --verbose | 打印调试信息。将此选项与-p和-t选项一起使用。 |
-V --version | 打印代理版本号并退出。 |
-R --runtime-control <option> | 执行管理功能。 查看 runtime control. |
特殊 例子 使用命令行参数:
运行时控制提供了一些远程控制选项。
操作 | 描述 |
---|---|
log_level_increase | 增加日志等级。 |
log_level_decrease | 降低日志等级。 |
metrics | 可用的指标列表。 |
version | 显示agent版本。 |
userparameter_reload | 从当前配置文件重新加载用户参数。 请注意UserParameter是将被重新加载的唯一agent配置选项。 |
help | 显示运行时控制的帮助信息 |
例子:
agent 2的配置参数大多与Zabbix agent 兼容,但也有一些例外。
新的参数 | 描述 |
---|---|
ControlSocket | 实时控制套接字路径。 Agent 2使用控制套接字 runtime commands. |
EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod |
这些参数用于在agent 2上为活动监控项配置持久存储. |
ForceActiveChecksOnStart | 确定agent是否应在重新启动后立即执行主动检查或随时间均匀分布。 自 Zabbix 6.0.2 起支持。 |
Plugins | 插件可能有自己的参数, 以 Plugins.<Plugin name>.<Parameter>=<value> 格式。 常见的插件参数是 Capacity, 设置可以同时执行的检查的限制。 |
StatusPort | agent 2将监听的端口,用于HTTP状态请求和显示已配置的插件列表以及一些内部参数 |
丢弃的参数 | 描述 |
AllowRoot, User | 不支持,因为守护进程不支持。 |
LoadModule, LoadModulePath | 不支持可加载模块。 |
StartAgents | 此参数在Zabbix agent中用于增加被动检查并发性或禁用它们。 在Agent 2,并发是在插件级别配置的,可以通过容量设置来限制。 然而,当前不支持禁用被动检查。 |
HostInterface, HostInterfaceItem | 不支持。 |
有关详细信息,请参阅配置文件选项zabbix_agent2.
从版本4.4.8开始,Zabbix agent 2也可以用 旧的OpenSSL版本(1.0.1,1.0.2)。
在这种情况下,Zabbix提供了在OpenSSL中锁定的互斥体。如果互斥锁锁定或解锁失败,则错误消息被打印到标准错误流(STDERR),Agent2退出,返回代码分别为2或3。