基于 Zabbix community-templates 监控 MikroTik PPPoE 活跃客户端数量(含触发器与图形配置)

原创2026-10-17 11:07:401,737 阅读

基于 Zabbix community-templates 监控 MikroTik PPPoE 活跃客户端数量(含触发器与图形配置)

导读

本文以 Zabbix Community Templates 仓库中的 template_quantidade_de_clientes_pppoe 模板为主线,讲解如何通过 SNMP 采集 MikroTik 路由器上当前在线(活跃)的 PPPoE 客户端数量,并利用模板内置的两条高优先级触发器实现"客户端数量异常"自动告警,同时借助内置图形直观查看在线趋势。读完本文,你将掌握该模板在 Zabbix 5.0 / 5.4 / 6.0 下的完整配置结构(监控项、触发器、图形),以及将它导入并接入实际 MikroTik 主机的操作要点。

该模板非常适合 ISP、宽带接入服务商或小区宽带运维场景:一旦 PPPoE 拨号用户数量出现骤增(可能对应异常故障或攻击)或骤降(可能对应链路中断、认证服务异常),即可第一时间感知。

模板定位与适用场景

template_quantidade_de_clientes_pppoe 位于仓库 Network_Devices/Mikrotik 目录下,作者为 Renato Severino,模板内部名称(template name)为 1 Check Active Client PPPoE。模板的原始描述为:

通过该模板可以检查连接到 MikroTik 的活跃客户端数量,并已内置触发器。

从仓库实现看,该模板刻意保持"极简单机监控"风格:

  • 无宏(Macros):README 明确标注 There are no macros links in this template.;
  • 无模板链接(Template links):不继承任何其他模板;
  • 无自动发现规则(Discovery rules):不使用 LLD,直接轮询一个固定 OID;
  • 监控项极简:全模板仅一个 SNMP 监控项。

这种设计带来的直接好处是:导入即可用,无需配置宏或依赖其他模板,适合只想快速获得"在线客户端数"这一单一指标的用户。

仓库中的文件与版本分布

该模板按 Zabbix 版本分别存放,仓库中三份导出文件内容一致,仅导出格式与版本号不同:

版本 导出格式 仓库路径
Zabbix 5.0 XML template_quantidade_de_clientes_pppoe.xml
Zabbix 5.4 YAML template_quantidade_de_clientes_pppoe.yaml
Zabbix 6.0 YAML template_quantidade_de_clientes_pppoe.yaml

5.4 与 6.0 的 YAML 导出在监控项、触发器、图形上完全一致(uuid 也相同),仅 zabbix_export.version 字段不同(5.4 vs 6.0),5.0 的 XML 则在应用(application)组织方式上略有差异。因此无论你的 Zabbix 版本是 5.0、5.4 还是 6.0,都可以直接找到对应文件导入。

核心监控项:Clientes Online(在线客户端数)

模板的全部监控逻辑集中在一个监控项上。以 5.4/6.0 YAML 导出为例(5.4 模板定义):

配置字段 值 说明
监控项名称(name) Clientes Online 即"在线客户端数"
类型(type) SNMP_AGENT 由 Zabbix Server/Proxy 主动 SNMP 轮询
SNMP OID 1.3.6.1.4.1.9.9.150.1.1.1.0 读取在线 PPPoE 客户端计数的 OID
键值(key) PPPoE 唯一标识,供触发器表达式与图形引用
更新间隔(delay) 30s 每 30 秒采集一次
历史保留(history) 7d 原始数据保留 7 天
趋势保留(trends) 30d 聚合趋势保留 30 天
应用(application) Verifica Conexões Ativas 该模板自建的分类应用,5.0 XML 中同样存在

各字段在 5.0 XML 导出中一一对应(见 5.0 XML 模板,snmp_oid、key、delay 等字段值与 YAML 完全一致)。

关于 OID 的说明

该监控项直接轮询叶子 OID 1.3.6.1.4.1.9.9.150.1.1.1.0。需要特别说明的是:

  • 该 OID 位于 1.3.6.1.4.1.9(Cisco 企业前缀)下的实验性 MIB 区域,模板作者将其用于读取 MikroTik 上活跃 PPPoE 客户端数量;
  • 仓库中的另一份模板 template_templete_ubiquiti(PPPOE ATIVOS / key pppoe.ativos)也使用了完全相同的 OID .1.3.6.1.4.1.9.9.150.1.1.1.0,说明这一 OID 在社区实践中被反复用作"PPPoE 活跃会话计数";
  • 从代码结构看,Zabbix 对该类 SNMP_AGENT 监控项的处理方式是:每个更新周期向目标主机的 161/UDP 端口发起一次 SNMP GET 请求,将返回的标量值(整数)作为监控项数值入库,因此该指标的实际取值正确性取决于目标 MikroTik 设备对该 OID 的返回行为。部署前建议先用 snmpget 手工验证目标设备对该 OID 的响应值与 :put [/ppp active print count] 的会话数是否一致。

内置触发器:客户端数量的双阈值告警

README 的自动生成表格中标注 "There are no triggers in this template.",但根据实际导出的 XML 与 YAML,模板明确内置了两条 HIGH 优先级触发器(README 自动生成的 "Triggers" 小节与导出文件不一致,应以 XML/YAML 为准)。两条触发器的表达式与含义如下:

触发器名称 表达式(5.4/6.0 YAML 形式) 优先级 告警语义
Mais de 1000 clientes conectados last(/1 Check Active Client PPPoE/PPPoE)>1000 HIGH 在线客户端数超过 1000
Menos de 100 clientes conectados last(/1 Check Active Client PPPoE/PPPoE)<100 HIGH 在线客户端数低于 100

在 5.0 XML 中,表达式使用相对函数简写形式:{last()}>1000 与 {last()}<100(5.0 XML 模板),两者语义等价,均表示"取该监控项最近一次采集值"。

触发器设计要点

  • 使用 last() 函数:只依据最近一次采样值判断,不做时间窗口聚合,响应最即时;
  • 双阈值方向告警:>1000 捕获"在线数异常暴增",<100 捕获"在线数异常暴跌",分别应对扩容瓶颈/异常注入与链路中断/认证故障两类问题;
  • manual_close: YES(手动关闭):两条触发器均设置为需要人工确认关闭,防止告警在阈值反复穿越时自动恢复又自动触发,便于运维保留告警痕迹、追踪根因;
  • 阈值需按实际规模调整:模板默认阈值(100 / 1000)针对中小规模接入场景;大规模 ISP 或超小型门店网络可直接在触发器表达式中修改数值,或在导入后复制触发器调整。

内置图形:Ativos Online(在线趋势图)

模板同时定义了一张名为 Ativos Online 的简单图形(5.4 YAML 图形定义):

  • 图中唯一数据序列引用监控项 PPPoE(host:1 Check Active Client PPPoE);
  • 线条颜色固定为 00DD00(绿色),与"在线正常"的语义一致;
  • 图形默认以折线形式展示在线客户端数随时间的波动,配合 30s 更新间隔可看到分钟级的在线变化。

该图形可直接放入 Zabbix 仪表盘(Dashboard)作为"当前在线用户数"的实时视图。

导入与接入 MikroTik 主机的操作步骤

  1. 导入模板:登录 Zabbix Web 前端,进入 Configuration → Templates → Import,选择与你的 Zabbix 版本匹配的文件(5.0 选 XML,5.4/6.0 选 YAML),勾选需要导入的实体后点击 Import;
  2. 确认模板就位:导入后可在模板列表中找到 1 Check Active Client PPPoE,展开可见监控项 Clientes Online、两条触发器与图形 Ativos Online;
  3. 关联主机:将目标 MikroTik 主机(Host)链接到该模板(Configuration → Hosts → 选择主机 → Templates → Add),或新建主机并选择该模板;
  4. 配置 SNMP 接口:确保主机配置了正确的 SNMP 接口(IP/端口)以及读写 community(模板为只读轮询,一般只需读 community),且与 MikroTik 上 /snmp 配置的 community 一致;
  5. 在 MikroTik 上启用 SNMP:通常需要在 MikroTik 侧开启 SNMP 服务并放行对应网段(例如 /snmp set enabled=yes contact=... location=...),同时在 /ip firewall filter 中允许 Zabbix Server 访问 UDP 161 端口;
  6. 验证数据采集:进入 Monitoring → Latest data,过滤主机与 PPPoE key,确认数值与 MikroTik 上的活跃 PPPoE 会话数一致;
  7. 核对告警阈值:根据网络实际规模评估默认的 100 / 1000 阈值是否合适,必要时编辑触发器表达式中的数值。

部署注意事项与调优建议

  • 更新间隔(delay: 30s):适合秒级感知在线变化;若设备较多或 SNMP 压力敏感,可在监控项上改为 60s 或更长;
  • 历史与趋势保留:7d 历史 + 30d 趋势为模板默认值,需要更长期回溯可调大 trends(注意磁盘占用);
  • OID 返回值的正确性验证:由于该 OID 前缀归属 Cisco 企业号,部署前务必用 SNMP 工具实测目标 MikroTik 的返回值,确认其确实代表活跃 PPPoE 客户端总数(可与 /ppp active print count 对照),避免误报;
  • 告警风暴控制:last() 单点判断在 SNMP 偶发超时时可能抖动,可结合 nodata() 或调整触发器为基于时间窗口的 avg()/max() 以更稳健;
  • 版本兼容:仓库提供了 5.0/5.4/6.0 三份导出,请勿在 Zabbix 7.x 直接导入 5.x 格式模板(如需升级可参考仓库中其他 7.0 目录模板的 YAML 结构进行格式转换)。

小结

template_quantidade_de_clientes_pppoe 是一个"小而精"的 MikroTik PPPoE 在线客户端监控模板:单一 SNMP 监控项(OID 1.3.6.1.4.1.9.9.150.1.1.1.0,key PPPoE,30s 轮询)、两条 HIGH 优先级双阈值触发器、一张绿色趋势图,覆盖了"在线数监控 + 异常告警 + 趋势可视化"的完整闭环。配合仓库中同作者的 template_monitoramento_de_mikrotik_sem_interface_pppoe(CPU、磁盘、内存、接口、温度、电压等基础监控)以及同目录下其他 MikroTik 模板,可组合成一套完整的 MikroTik 接入网监控方案。

登录后查看全文
community-templates