在这篇博客文章中,您将了解如何为 Zabbix 添加简单的容器远程控制功能,以便在已发现的主机中启动、停止或重启容器。
您可能会问,为什么要花功夫为每个模板创建一个主机?这是因为我们要定义一个手动脚本,以便在 Zabbix 前端中控制容器。很巧妙,对吧?而且何必止步于此?我们还可以实现一个触发器动作,在容器因任何原因崩溃时自动重启该容器。
Zabbix server 配置更改
首先,我们需要在您的 Zabbix server 配置中启用全局脚本执行:
# nano /etc/zabbix/zabbix_server.conf EnableGlobalScripts=1 # systemctl restart zabbix-server
在前端配置脚本
我们可以在告警 > 脚本部分创建脚本。在脚本中填写下面列出的参数:范围、类型和命令。然后指定该命令适用于哪些主机,以及可以执行该命令的用户组。该脚本将利用用户宏和内置宏在命令中填入所需信息,以发出正确的 POST 请求。
● Script
▪ Name: Container action
▪ Scope : Manual host action
▪ Type: Script
▪ Execute on: Zabbix server
▪ Commands: curl -sS -X POST https://{$DOCKER.IP}:{$DOCKER.PORT}/containers{HOST.NAME}/{MANUALINPUT} --cert /etc/zabbix/ssl/certs/client-cert.pem --key /etc/zabbix/ssl/keys/client-key.pem --cacert /etc/zabbix/ssl/ca/ca.pem
▪ Description: Manual action to restart,stop,start container
▪ Host group: Selected: Docker
▪ User group: Zabbix administrators
▪ Req host perm: Write
● Advanced configuration
▪ Enable user input Check
▪ Input prompt Specify action for container {HOST.NAME}:
▪ Input type: Dropdown
▪ Dropdown options: restart,stop,start
▪ Enable Confirmation: Check
▪ Confirmation text: Confirm to {MANUALINPUT} container: {HOST.NAME}

手动执行主机脚本
我们可以转到菜单部分监测 > 主机,选择主机并单击该主机。在菜单中,您会看到一个可用于 Docker 主机组的附加脚本 Container action。此手动操作在其他一些前端部分中也可用。

单击 Container action 后,您将看到多个可用选项。您可以启动、重启或停止容器。

随后会出现一个确认窗口,询问这是否确实是您要执行的操作。


采集到指标后(主监控项为 1 分钟),也可以在主机的最新数据菜单中查看状态。监控项 Container /zabbix-agent2: Running 显示该容器未在运行,另一个监控项显示退出代码 0,这意味着进程已正常停止,没有任何问题。

有些监控项以数字格式报告状态,例如 0、1、2 等。为了便于阅读,我们使用值映射,以有意义且易于理解的方式显示值。下面的截图显示了容器健康状态的值映射。因此,我们看到的不是容器健康状态的值 3(这个值对我们来说没有意义,还需要查阅文档),而是值 healthy (3)。

容器崩溃恢复自动化
如果您的容器因某种原因崩溃怎么办?此时您会收到一个问题事件,可以利用该事件接收有关容器问题的通知。您还可以将容器恢复过程自动化。例如,创建一个触发器动作,以 2 分钟的间隔重启容器 3 次。
只有在这样仍无法解决问题时,才向管理员发送消息。没有理由无休止地反复重启服务:如果几次尝试都不奏效,那么很可能需要人工干预才能解决问题。
以下是用于动作操作的脚本参数:
● Script
▪ Name: Restart container
▪ Scope: Action operation
▪ Type: Script
▪ Execute on: Zabbix server
▪ Commands: curl -sS -X POST https://{$DOCKER.IP}:{$DOCKER.PORT}/containers{HOST.NAME}/restart --cert /etc/zabbix/ssl/certs/client-cert.pem --key /etc/zabbix/ssl/keys/client-key.pem --cacert /etc/zabbix/ssl/ca/ca.pem
▪ Description: Restart container
▪ Host group: Selected: Docker

现在,我们需要定义一个触发器动作来使用此脚本,并在失败时向管理员发送通知。
让我们创建一个新的触发器动作:
● Action tab
▪ Name: Automatic container restart
▪ Type of calc: And (A and B)
▪ condition: Host group equals Docker
▪ condition: Event name contains Container has been stopped with error code
▪ Enabled: Check
● Operations tab
▪ Default operation step duration: 2m
Add operation
▪ Operation: Current host: Check
▪ Steps: 1 -3
Add operation
▪ Operation: Send message
▪ Steps: 4 – 4
▪ Custom message: Check
▪ Subject: Automated restart failed to bring container up: {HOST.NAME}
▪ Message: <b>Host: {HOST.NAME}<br>
<b>Problem started at {EVENT.TIME} on {EVENT.DATE}<br>
<b>Operational data: {EVENT.OPDATA}<br>
<b>Original problem ID: {EVENT.ID}<br>



该动作应与下面的截图一致。保存该动作。

测试容器崩溃自动恢复
我使用命令 docker kill zabbix-agent2 停止容器。容器停止时的退出代码不为 0,因此当监控项接收到数据时(在我的环境中为 1 分钟后),我会收到一个问题事件。如果问题事件尚未解决,触发器动作会立即执行脚本 Container restart,并在 2 分钟后和 4 分钟后再次执行。

该脚本成功重启了容器。容器重新运行,问题事件已解决。

我们来看看我能否足够快地反复终止 west proxy 容器,赶在监控项采集到容器运行状态的数据之前。结果我确实抢先了一步,所以现在您将看到,当它“未能”使容器恢复运行状态时会发生什么。在这里的“动作”中,我们可以看到 Zabbix 执行了三次脚本(我也足够快地停止了容器 3 次!),之后动作向管理员发送了通知,告知通过重启未能使容器恢复运行。

我收到了消息:容器重启未能使容器进入运行状态,需要人工处理才能解决。

总结
现在,您已经了解如何提前规划并利用 Zabbix 的内置功能,(在可能的情况下)无需人工干预即可解决问题,并且仅在自动修复尝试失败时才接收通知。