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