Close
Log in to Zabbix Blog
Email
Password
Show password Hide password
Forgot password?
Incorrect e-mail and/or password
or
By creating an account or logging in with an existing account, you agree to our Terms of Service
案例研究如何技术的社区会议登录

Zabbix 与 Docker API,第 3 部分:控制

在这篇博客文章中,您将了解如何为 Zabbix 添加简单的容器远程控制功能,以便在已发现的主机中启动、停止或重 […]

在这篇博客文章中,您将了解如何为 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}

图 1. 脚本配置

手动执行主机脚本

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

图 2. 可在主机上手动执行的脚本

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

图 3. 脚本的下拉菜单选项

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

图 4. 执行确认窗口
图 5. 执行成功时的脚本输出。

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

图 6. Zabbix agent 2 容器的最新数据

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

图 7. 模板中预定义的值映射

容器崩溃恢复自动化

如果您的容器因某种原因崩溃怎么办?此时您会收到一个问题事件,可以利用该事件接收有关容器问题的通知。您还可以将容器恢复过程自动化。例如,创建一个触发器动作,以 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
图 8. 脚本动作参数

现在,我们需要定义一个触发器动作来使用此脚本,并在失败时向管理员发送通知。

让我们创建一个新的触发器动作:

● 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>
图 9. 新的动作:动作选项卡
图 10. 动作的操作选项卡:新操作,步骤 1-3
图 11. 动作的操作选项卡:新步骤 4-4

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

图 12. 已定义的动作操作

测试容器崩溃自动恢复

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

图 13. 关于容器已停止、退出代码为 137 的问题事件

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

图 14. 已解决的事件与远程脚本执行

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

图 15. 关于容器已停止、退出代码为 137 的问题事件

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

图 16. 电子邮件中的问题事件通知

总结

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

 

Prev Post Prev Post Next Post Next Post
订阅评论
提醒
0 Comments
最旧
最新 最多投票
0
希望看到您的想法,请您发表评论x