Zabbix 社区模板 APT Debian 实战:通过 Zabbix agent 监控 Debian 系统可更新软件包数量
Zabbix 社区模板 APT Debian 实战:通过 Zabbix agent 监控 Debian 系统可更新软件包数量
本文基于 community-templates 仓库中的 APT Debian 模板文档 与同目录的模板导出文件,讲解该模板的监控目标、模板文件结构与各版本差异,并给出导入部署步骤和自定义监控键 apt.upgradable 的落地方式。读完本文,你将能够正确导入该模板、在 Zabbix agent 侧实现可更新软件包计数,并准确理解其触发器与图形的设计意图。
1. 模板概述与版本分布
README 对模板的定位非常明确:
This template allow to monitor packets to update in debian based OS.(该模板用于监控基于 Debian 的操作系统中待更新的软件包)
模板作者为 mer。从仓库目录结构看,该模板按 Zabbix 大版本提供了三个独立导出,分别位于:
| 适用版本 | 目录 | 导出文件 | 说明 |
|---|---|---|---|
| Zabbix 5.0 | Applications/template_zabbix-apt/5.0/ |
template_zabbix-apt.xml | XML 格式导出(旧格式) |
| Zabbix 5.4 | Applications/template_zabbix-apt/5.4/ |
template_zabbix-apt.yaml | YAML 格式导出 |
| Zabbix 6.0 | Applications/template_zabbix-apt/6.0/ |
template_zabbix-apt.yaml | YAML 格式导出 |
三个版本的核心逻辑一致,仅导出格式与组织方式不同。以 6.0 版 YAML 导出文件 template_zabbix-apt.yaml 为例,其头部声明为:
zabbix_export:
version: '6.0'
date: '2021-11-21T21:25:23Z'
groups:
-
uuid: 7df96b18c230490a9a0a9e2307226338
name: Templates
其中 version: '6.0' 表明该导出面向 Zabbix 6.0 服务器导入;name: Templates 说明模板默认挂载在名为 Templates 的主机群组中。值得注意的是,5.0 版 XML 导出使用的是 Zabbix 早期版本的遗留结构(通过 <applications><application><name>APT</name></application></applications> 标记应用分类),而 5.4/6.0 版则改用标签(tags)机制,这是两个时代导出格式的典型差异。
2. 模板结构总览:README 声明与导出文件对照
README 采用仓库统一的模板文档骨架,逐项声明了模板的组成要素:
- Macros used:There are no macros links in this template.(无全局宏/用户宏)
- Template links:There are no template links in this template.(无父模板链接)
- Discovery rules:There are no discovery rules in this template.(无 LLD 发现规则)
- Items collected:仅一个监控项,见下文第 3 节
对照 6.0 版 YAML 导出 可以验证上述声明:文件中确实不存在 macros、template_links 和 discovery_rules 等节点,整个模板只包含 1 个监控项、1 个触发器和 1 个图形。这意味着该模板无需配置任何宏即可使用,部署门槛很低——但这也意味着监控逻辑完全集中在唯一的监控项 apt.upgradable 上,其实现质量直接决定模板可用性。
3. 唯一的监控项:apt.upgradable
README 的 "Items collected" 表格给出了该监控项的核心属性:
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Upgradable packets | - | Zabbix agent | apt.upgradable,Update: 3600 |
结合 6.0 版 YAML 导出 的完整定义:
items:
-
uuid: fcd302605ab841f89dcc60d581cda89c
name: 'Upgradable packets'
key: apt.upgradable
delay: '3600'
tags:
-
tag: Application
value: APT
各属性含义如下:
| 属性 | 值 | 说明 |
|---|---|---|
| 名称 | Upgradable packets |
显示名称 |
| 键值 | apt.upgradable |
自定义键,需由 agent 侧提供(见第 4 节) |
| 类型 | Zabbix agent | 未显式指定时默认为 passive 的 Zabbix agent 采集 |
| 更新间隔 | 3600 |
每 3600 秒(1 小时)采集一次 |
| 标签 | Application: APT |
用于 Zabbix 6.0 的标签筛选与前端展示 |
1 小时的采集间隔与"可更新软件包数量"这类变化缓慢的指标是匹配的:软件包索引本身不会高频变化,过短的轮询间隔只会增加 apt list --upgradable 这类命令的执行开销。
4. 在 agent 侧实现自定义键 apt.upgradable
这是使用该模板最关键的一步。apt.upgradable 并不是 Zabbix agent 的内置键值——从模板导出结构看,它没有任何内置键的特征命名(如 system.*、net.if.*),可以推断该键需要在被监控主机上通过 UserParameter 自定义实现。仓库本身未附带实现脚本,以下给出一种典型的通用实现方式作为参考(属于示例做法,非仓库自带文件):
在 Zabbix agent 配置目录(如 /etc/zabbix/zabbix_agentd.d/ 下新建 apt.conf)中添加:
UserParameter=apt.upgradable,apt list --upgradable 2>/dev/null | grep -c upgradable
其工作原理:
apt list --upgradable会列出当前软件包索引中所有存在更新版本的包,每行形如nginx/stable now; stable [upgradable from: ...];grep -c upgradable统计匹配行数,即输出待更新软件包的数量;2>/dev/null抑制 apt 可能输出的警告信息,保证输出是纯数字。
另一种等效思路是使用模拟升级方式计数:
UserParameter=apt.upgradable,apt-get -s upgrade 2>/dev/null | grep -c '^Inst'
使用时需注意以下前提与限制:
- 数值依赖软件包索引的新鲜度。
apt list --upgradable只依据本地索引缓存计算,如果主机长期不执行apt update,返回值可能停留在旧值。建议配合unattended-upgrades或定时任务保持索引刷新,并理解这一点:该指标反映的是"索引快照中的待更新数量",而非"远端此刻的待更新数量"。 - 执行权限。命令需要能访问 apt 数据库,通常要以具备相应权限的用户执行;若 agent 以普通用户运行,需要在
sudoers中为该命令配置免密执行。 - 验证方式。配置完成后,可在主机上手动执行
zabbix_get -s <IP> -k apt.upgradable或等待 agent 上报,确认返回为数字而非报错文本,再观察触发器与图形的表现。
5. 触发器:README 声明与导出文件的差异
这里需要特别指出一个文档与文件的不一致之处:README 的 Triggers 章节写着 "There are no triggers in this template.",但 6.0 版 YAML 导出 中实际定义了一个触发器(5.4 版 YAML 与 5.0 版 XML 同样包含该触发器)。因此实际行为应以模板导出文件为准:
triggers:
-
uuid: 250761b19cc640db9b72b8582bb74d0b
expression: 'last(/APT Debian/apt.upgradable)>0'
name: '{HOST.NAME} Have Packets to update'
priority: INFO
manual_close: 'YES'
触发器属性说明:
| 属性 | 值 | 说明 |
|---|---|---|
| 名称 | {HOST.NAME} Have Packets to update |
自动替换为主机名,便于事件列表中定位 |
| 表达式 | last(/APT Debian/apt.upgradable)>0 |
取最近一次采集值,大于 0(存在待更新包)即触发;5.0 版 XML 中写作等价简写 {last()}>0 |
| 严重度 | INFO |
提示级,不产生高优告警 |
| 手动关闭 | manual_close: 'YES' |
触发后不会自动恢复 |
两点使用提示:
- 该触发器刻意选用
last()且不带任何持续时间条件,即"只要最新一次采集发现有待更新包就提示"。这与 1 小时的采集间隔配合,形成一种低频的更新提醒机制。 - 由于开启了手动关闭,完成软件包更新后事件不会自动消失,需要人工关闭。这是作者有意为之的设计(避免"误恢复"语义),但运维上应知道这一点;如果希望自动恢复,可自行在副本中修改触发器设置(注意:应修改自己环境中的模板副本,而不是仓库文件)。
6. 图形:Upgradable packets count
6.0 版 YAML 导出 还包含一个图形,用于观察待更新软件包数量的变化趋势:
graphs:
-
uuid: ff79a398339746a3936b1e117b3d9231
name: 'Upgradable packets count'
height: '300'
graph_items:
-
color: 1A7C11
calc_fnc: ALL
item:
host: 'APT Debian'
key: apt.upgradable
- 图形高度 300px,曲线颜色为
#1A7C11(深绿色),calc_fnc: ALL表示绘制所有数据点; - 该图形的实际价值在于趋势观察:若曲线持续攀升,通常说明系统距上次大批量更新的时间越来越长,是安排维护窗口的直接依据;
- 由于采集间隔为 1 小时,图形呈现的是"每小时一个点"的阶梯式变化,属于正常现象。
7. 导入与部署步骤
按照仓库 README 中给出的通用模板使用流程,结合本模板的特点,部署步骤如下:
- 选择对应版本文件下载:Zabbix 5.0 选 XML 导出;5.4 与 6.0 分别选对应的 YAML 导出 与 6.0 YAML 导出。
- 导入模板:在 Zabbix 前端通过 配置 → 模板 → 导入 上传对应文件,模板名为
APT Debian,默认归属Templates主机群组。 - 配置被监控主机:
- 主机需安装 Zabbix agent 并完成注册;
- 按第 4 节方式实现
UserParameter=apt.upgradable; - 将该主机关联
APT Debian模板。
- 无需额外配置:如 README 所述,模板不含宏、不含父模板链接、不含发现规则,导入后即可工作;等待一个采集周期(最长 1 小时)后即可看到数据、触发器状态与图形。
8. 适用前提与局限性小结
- 仅适用于使用 apt 的 Debian 系系统(Debian、Ubuntu 等);基于其他包管理器的系统不适用;
- 指标为数量级的待更新包计数,不提供具体是哪些包、更新级别(安全/常规)等明细;若需明细,需要自行扩展 agent 侧脚本并另建模板;
- 采集间隔 1 小时,且数值受
apt update执行频率影响,理解"索引快照"语义才能正确解读数据; - 触发器为 INFO 级且手动关闭,定位为更新提醒而非故障告警;
- README 的 Triggers 章节与导出文件存在出入(见第 5 节),以模板导出文件中的实际定义为准。
参考文件: