Zabbix 社区模板 APT Debian 实战:通过 Zabbix agent 监控 Debian 系统可更新软件包数量

原创2026-10-15 17:54:101,811 阅读

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'

使用时需注意以下前提与限制:

  1. 数值依赖软件包索引的新鲜度。apt list --upgradable 只依据本地索引缓存计算,如果主机长期不执行 apt update,返回值可能停留在旧值。建议配合 unattended-upgrades 或定时任务保持索引刷新,并理解这一点:该指标反映的是"索引快照中的待更新数量",而非"远端此刻的待更新数量"。
  2. 执行权限。命令需要能访问 apt 数据库,通常要以具备相应权限的用户执行;若 agent 以普通用户运行,需要在 sudoers 中为该命令配置免密执行。
  3. 验证方式。配置完成后,可在主机上手动执行 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 中给出的通用模板使用流程,结合本模板的特点,部署步骤如下:

  1. 选择对应版本文件下载:Zabbix 5.0 选 XML 导出;5.4 与 6.0 分别选对应的 YAML 导出 与 6.0 YAML 导出。
  2. 导入模板:在 Zabbix 前端通过 配置 → 模板 → 导入 上传对应文件,模板名为 APT Debian,默认归属 Templates 主机群组。
  3. 配置被监控主机:
    • 主机需安装 Zabbix agent 并完成注册;
    • 按第 4 节方式实现 UserParameter=apt.upgradable;
    • 将该主机关联 APT Debian 模板。
  4. 无需额外配置:如 README 所述,模板不含宏、不含父模板链接、不含发现规则,导入后即可工作;等待一个采集周期(最长 1 小时)后即可看到数据、触发器状态与图形。

8. 适用前提与局限性小结

  • 仅适用于使用 apt 的 Debian 系系统(Debian、Ubuntu 等);基于其他包管理器的系统不适用;
  • 指标为数量级的待更新包计数,不提供具体是哪些包、更新级别(安全/常规)等明细;若需明细,需要自行扩展 agent 侧脚本并另建模板;
  • 采集间隔 1 小时,且数值受 apt update 执行频率影响,理解"索引快照"语义才能正确解读数据;
  • 触发器为 INFO 级且手动关闭,定位为更新提醒而非故障告警;
  • README 的 Triggers 章节与导出文件存在出入(见第 5 节),以模板导出文件中的实际定义为准。

参考文件:

登录后查看全文
community-templates