Zabbix 社区模板实战:基于 SNMP 无代理监控 MikroTik 路由器的全维度方案(CPU/内存/磁盘/接口/温压/固件)
Zabbix 社区模板实战:基于 SNMP 无代理监控 MikroTik 路由器的全维度方案(CPU/内存/磁盘/接口/温压/固件)
本文围绕 community-templates 仓库中面向 Zabbix 的 MikroTik 监控模板 template_monitoramento_de_mikrotik_sem_interface_pppoe 展开,完整解读该模板的监控维度、宏定义、三条自动发现规则、全部监控项、触发器与图形,并结合 6.0 版 YAML 源码给出每个关键监控项的 SNMP OID、轮询间隔与预处理细节。读完本文,你将能够在 Zabbix 中导入并部署这套无需安装任何 Agent 的纯 SNMP 监控方案,掌握其「常规监控 + LLD 自动发现」的双层设计,并理解温度、固件升级等触发器的实际告警逻辑。
模板定位与监控范围
该模板由社区作者 Renato Severino 贡献(README.md),模板名称为 Mikrotik,适用于通过 SNMP 协议对 RouterOS 设备进行无代理监控,无需在设备上安装 Zabbix Agent。模板目录名中的 sem_interface_pppoe(葡萄牙语,意为"无 PPPoE 接口")表明其设计思路是聚焦设备本体的系统级监控,不对 PPPoE 隧道接口做专门处理。
从模板 Overview 可以看出,它覆盖了以下监控维度:
- CPU:整体负载(
CPU Load)与多核发现(Verificar CPULLD) - DISCO(磁盘):总空间、已用空间与按存储卷发现的空间利用率
- MEMORIA(内存):总内存与已用内存
- INTERFACE(接口):流量、错误、丢弃、速率、状态与链路告警
- NOME DO EQUIPAMENTO(设备名称):
System name - UPTIME(运行时间):
System uptime - TEMPERATURA(温度):机内温度传感器
- VOLTAGEM(电压):供电电压
- VERSÃO DO MIKROTIK(RouterOS 版本):活动固件版本、待升级固件版本、软件 ID、序列号、硬件描述
模板在仓库中提供了三个 Zabbix 版本分支,实现内容保持一致:
本文以 6.0 分支为主要分析对象(6.0 YAML 头部声明 zabbix_export: version: '6.0',导出日期 2021-11-21)。5.0 分支触发器使用旧式函数语法(如 {Mikrotik:...}.diff()),5.4/6.0 分支则使用新式表达式语法(如 last(/Mikrotik/...)),其余监控项结构基本一致。
宏定义:唯一需要按环境调整的变量
模板只定义了一个宏(见 6.0 README.md 的 "Macros used" 部分):
| 宏名 | 说明 | 默认值 | 类型 |
|---|---|---|---|
{$SNMP_COMMUNITY} |
SNMP 团体字符串 | sksnmp |
文本宏 |
在 6.0 YAML 源码 的 macros 段中,其定义为 {$SNMP_COMMUNITY} = sksnmp。这一点是部署时最需要留意的:模板默认团体名为 sksnmp(作者环境自定义值),导入后必须按你的实际 RouterOS SNMP 配置覆盖该宏,否则所有监控项都会因认证失败而报 "Timeout while executing SNMP" 或 "SNMP error"。
在 RouterOS 侧,可通过 Winbox 或 CLI 启用 SNMP 并设置团体名(以 CLI 为例):
/snmp set enabled=yes community=sksnmp contact=... location=...
若设备处于桥接/跨网段场景,还需在 /snmp 下确认允许访问的地址范围。部署时建议在主机级别直接修改宏值为设备真实团体名,而不是逐个修改模板默认值,这样一台模板可复用于多个站点。
三条自动发现规则(LLD):接口、存储与多核 CPU
模板的核心亮点在于用三条 SNMP LLD 规则把「接口列表、存储卷、CPU 核数」这类数量不固定的对象自动化纳管,新增/删除接口或 CPU 核时无需手工维护监控项。
Network Interfaces Discovery:接口自动发现
- 名称:
Network Interfaces Discovery - Key:
net.if.discovery - 轮询间隔:60s
- 数据来源:SNMP agent
其 snmp_oid 通过 discovery<a href="https://link.gitcode.com/i/b58b03fdf188856e07fe77025203b70d" target="_blank">{#SNMPVALUE},...] 语法一次性拉取多个表列(见 [YAML 源码):
snmp_oid: 'discovery[{#SNMPVALUE},1.3.6.1.2.1.2.2.1.8,{#IFADMINSTATUS},1.3.6.1.2.1.2.2.1.7,{#IFALIAS},1.3.6.1.2.1.31.1.1.1.18,{#IFNAME},1.3.6.1.2.1.31.1.1.1.1,{#IFDESCR},1.3.6.1.2.1.2.2.1.2,{#IFTYPE},1.3.6.1.2.1.2.2.1.3]'
即从 IF-MIB 与 IF-MIB(64 位部分)中取出 ifOperStatus、ifAdminStatus、ifAlias、ifName、ifDescr、ifType,生成 {#SNMPINDEX}、{#IFNAME}、{#IFALIAS} 等宏供后续 item prototype 使用。
发现过滤条件(evaltype: AND,三个条件须同时满足):
| 条件宏 | 取值 | 含义 |
|---|---|---|
{#IFADMINSTATUS} |
`(1 | 3)` |
{#IFNAME} |
@Network interfaces for discovery |
使用命名列表白名单过滤接口名 |
{#IFTYPE} |
`(6 | 135 |
第 2 个条件引用的是 Zabbix 用户宏命名列表(默认位置:Administration → General → Other → Named lists),你可以按需在命名列表 Network interfaces for discovery 中增减接口名,从而精确控制"哪些接口进入监控"。该 LLD 还设置了 lifetime: 2h,即接口消失后 2 小时自动清理相关监控项。
Storage discovery:存储卷自动发现
- 名称:
Storage discovery - Key:
storage.discovery - 轮询间隔:1h
- 说明:
HOST-RESOURCES-MIB::hrStorage discovery with storage filter
snmp_oid: 'discovery[{#SNMPVALUE},1.3.6.1.2.1.25.2.3.1.3,{#ALLOC_UNITS},1.3.6.1.2.1.25.2.3.1.4,{#STORAGE_TYPE},1.3.6.1.2.1.25.2.3.1.2]'
基于 HOST-RESOURCES-MIB 的 hrStorageTable(.1.3.6.1.2.1.25.2.3.1),收集 hrStorageDescr、hrStorageAllocationUnits、hrStorageType,从而把磁盘、闪存、内存等存储实体都纳入发现范围。
Verificar CPU:多核 CPU 自动发现
- 名称:
Verificar CPU - Key:
system.discoverycpu - 轮询间隔:3s(模板中最快的轮询项)
snmp_oid: 'discoverycpu[{#IFCPUNUM},1.3.6.1.2.1.25.3.3.1.2]'
通过 HOST-RESOURCES-MIB 的 hrProcessorTable(.1.3.6.1.2.1.25.3.3.1.2,即 hrProcessorLoad)发现每个 CPU 核,为每核生成 Uso de CPU {#SNMPINDEX} 监控项。3 秒的轮询间隔适合捕捉瞬时负载尖峰,但在大规模部署时建议留意 SNMP 轮询频率对设备 CPU 的开销。
常规监控项:SNMP OID 与预处理全解析
模板包含 15 个直接定义的 SNMP 监控项(不依赖 LLD)。下表按 6.0 YAML 的 items 段整理:
| 监控项名称 | Key | SNMP OID | 轮询间隔 | 单位 | 预处理 |
|---|---|---|---|---|---|
| System name | mikrotik.identity.name |
.1.3.6.1.2.1.1.5.0(sysName) |
10m | -(字符) | 无 |
| Software ID | mikrotik.software.id |
.1.3.6.1.4.1.14988.1.1.4.1.0(MTX 私有 MIB) | 10m | -(字符) | 无 |
| Espaco Total em Disco | mikrotik.total.disk.space |
.1.3.6.1.2.1.25.2.3.1.5.131073(hrStorageSize) |
10m | B | ×1024 |
| Espaco usado em Disco | mikrotik.used.disk.space |
.1.3.6.1.2.1.25.2.3.1.6.131073(hrStorageUsed) |
5m | B | ×1024 |
| Memoria Total | mikrotik.total.memory |
.1.3.6.1.2.1.25.2.3.1.5.65536 | 1h | B | ×1024 |
| Memoria em Uso | mikrotik.used.memory |
.1.3.6.1.2.1.25.2.3.1.6.65536 | 30s | B | ×1024 |
| System uptime | mikrotik.uptime |
.1.3.6.1.2.1.1.3.0(sysUpTime) |
2m | uptime | ×0.01 |
| System version and hw | mikrotik.version.and.hw |
iso.3.6.1.2.1.47.1.1.1.1.2.65536(entPhysicalDescr) |
10m | -(字符) | 无 |
| CPU Load | mtxCPULoad |
.1.3.6.1.2.1.25.3.3.1.2.1(hrProcessorLoad) |
30s | % | 无 |
| Rede - DHCP Leases | mtxrDHCPLeaseCount |
1.3.6.1.4.1.14988.1.1.6.1.0 | 1m | - | 无 |
| Firmware Ativo | mtxrFirmwareVersion |
1.3.6.1.4.1.14988.1.1.7.4.0 | 10m | -(FLOAT) | 无 |
| Firmware Aguardando Upgrade | mtxrFirmwareUpgradeVersion |
1.3.6.1.4.1.14988.1.1.7.7.0 | 10m | -(FLOAT) | 无 |
| Serial Number | mtxrSerialNumber |
1.3.6.1.4.1.14988.1.1.7.3.0 | 30s | -(字符) | 无 |
| Temperatura | mtxrHlTemperature |
1.3.6.1.4.1.14988.1.1.3.10.0 | 1m | C | ×0.1 |
| Voltagem | mtxrHlVoltage |
.1.3.6.1.4.1.14988.1.1.3.8.0 | 1m | V | ×0.1 |
| Frequencia Processador | mtxrHlProcessorFrequency |
1.3.6.1.4.1.14988.1.1.3.14.0 | 10m | Mhz | 无 |
几个值得深入理解的实现细节:
-
1.3.6.1.4.1.14988是 MikroTik 私有 Enterprise OID,mtxr*系列 key 全部来自 MIKROTIK-MIB:mtxrHlTemperature/mtxrHlVoltage/mtxrHlProcessorFrequency属于健康监控(Health Monitor)分支,mtxrFirmwareVersion/mtxrFirmwareUpgradeVersion/mtxrSerialNumber属于系统信息分支,mtxrDHCPLeaseCount属于 DHCP 分支。而mikrotik.*系列 key 则混合使用标准 MIB(如hrStorageSize)与 MTX 私有 MIB。 -
预处理 ×1024 的缘由:
hrStorageSize/hrStorageUsed返回的单位是hrStorageAllocationUnits(对 RouterOS 而言通常是 1KB 的倍数),乘以 1024 后换算为字节(B),保证后续磁盘/内存数据以B为单位展示。 -
温度与电压的 ×0.1:MikroTik 健康传感器在 SNMP 中返回的是"十分之一单位"的整数值,乘以 0.1 后还原为真实摄氏度(C)与伏特(V)。例如原始值 370 表示 37.0°C。
-
uptime 的 ×0.01:
sysUpTime的 TimeTicks 单位为百分之一秒,乘以 0.01 后转成秒,配合units: uptime让 Zabbix 自动格式化为「Xd Yh Zm」风格。 -
间隔分层设计:变化快的指标轮询快(CPU Load 30s、内存使用 30s、温度/电压 1m、DHCP 租约 1m),变化慢的指标轮询慢(总内存 1h、固件/软件 ID/系统名 10m)。这既是合理的采集节奏,也能显著降低对低端 RouterBoard 的 SNMP 压力。
-
历史与趋势保留策略:多数数值型监控项设置了
history: 365d、trends: 734d,适合做长期容量分析;字符型监控项(trends: '0')不保留趋势数据。
LLD 原型监控项:接口、磁盘与 CPU 核
接口原型(由 Network Interfaces Discovery 生成)
每个被发现的接口自动生成 8 个监控项(定义在 YAML 的 item_prototypes 中):
| 原型名称 | Key | OID | 间隔 | 单位/预处理 |
|---|---|---|---|---|
| Discards In | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] |
.1.3.6.1.2.1.2.2.1.13 | 300s | CHANGE_PER_SECOND |
| Erros In | net.if.in.errors[ifInErrors.{#SNMPINDEX}] |
.1.3.6.1.2.1.2.2.1.14 | 300s | CHANGE_PER_SECOND |
| Bytes In | net.if.in[ifHCInOctets.{#SNMPINDEX}] |
.1.3.6.1.2.1.31.1.1.1.6 | 120s;工作日 07:00-21:00 为 30s | bps:CHANGE_PER_SECOND + ×8 |
| Discards Out | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] |
.1.3.6.1.2.1.2.2.1.19 | 300s | CHANGE_PER_SECOND |
| Erros Out | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] |
.1.3.6.1.2.1.2.2.1.20 | 300s | CHANGE_PER_SECOND |
| Bytes Out | net.if.out[ifHCOutOctets.{#SNMPINDEX}] |
.1.3.6.1.2.1.31.1.1.1.10 | 120s;工作日 07:00-21:00 为 30s | bps:CHANGE_PER_SECOND + ×8 |
| Speed | net.if.speed[ifHighSpeed.{#SNMPINDEX}] |
.1.3.6.1.2.1.31.1.1.1.15 | 300s | Mbps:×1000000 |
| Operational status | net.if.status[ifOperStatus.{#SNMPINDEX}] |
.1.3.6.1.2.1.2.2.1.8 | 240s;工作日 07:00-21:00 为 120s | - |
实现要点:
- 流量用 64 位计数器(
ifHCInOctets/ifHCOutOctets),避免 32 位计数器在高速链路(>100Mbps)上快速回绕的问题;预处理链先CHANGE_PER_SECOND求每秒字节增量,再 ×8 换算为 bit/s,单位设为bps。 Speed项 ×1000000:ifHighSpeed的计量单位是 Mbps(如 1000 表示 1Gbps),乘 1000000 后转为 bps,与流量数据的量纲对齐。- 错误/丢弃项同样施加
CHANGE_PER_SECOND,将计数器转换为"每秒错误数/丢弃数"的速率视图,更利于观察突发丢包。 delay: '120;30/2-6,07:00-21:00'是 Zabbix 的调度型轮询间隔:默认 120s,但在每周二至周六 07:00-21:00 的"工作时段"降为 30s——这是模板对「业务高峰加密采样、闲时降频」的实用设计。
磁盘原型(由 Storage discovery 生成)
每个发现的存储实体生成 3 个监控项,均带 Application: Storage 标签:
| 原型名称 | Key | 类型 | 说明 |
|---|---|---|---|
| Disk-{#SNMPINDEX}: Total space | vfs.fs.total[hrStorageSize.{#SNMPINDEX}] |
SNMP agent | 卷总容量(B),OID .1.3.6.1.2.1.25.2.3.1.5.{#SNMPINDEX} |
| Disk-{#SNMPINDEX}: Used space | vfs.fs.used[hrStorageSize.{#SNMPINDEX}] |
SNMP agent | 卷已用容量(B),OID .1.3.6.1.2.1.25.2.3.1.6.{#SNMPINDEX} |
| Disk-{#SNMPINDEX}: Space utilization | vfs.fs.pused[hrStorageSize.{#SNMPINDEX}] |
Calculated | 空间利用率(%),表达式:(last(//vfs.fs.used[hrStorageSize.{#SNMPINDEX}])/last(//vfs.fs.total[hrStorageSize.{#SNMPINDEX}]))*100 |
空间利用率是模板中唯一的计算型监控项(type: CALCULATED,见 YAML 的 params 字段),它不复用 SNMP 轮询,而是基于上述两个 SNMP 项的 latest value 现场求比值,既省一次网络请求,也天然规避了 SNMP 计数器的单位换算误差。三个原型轮询间隔均为 1m。
CPU 核原型(由 Verificar CPU 生成)
| 原型名称 | Key | OID | 间隔 | 单位 |
|---|---|---|---|---|
| Uso de CPU {#SNMPINDEX} | cpucore[ifnum{#SNMPINDEX}] |
.1.3.6.1.2.1.25.3.3.1.2.{#SNMPINDEX} | 1m | % |
与整体的 CPU Load(hrProcessorLoad 索引 1,30s)互为补充:整体负载看"平均",cpucore 系列看"每核独立负载",便于定位多核设备上单核打满的情况。
触发器:链路、温度与固件升级
README 的 Triggers 部分列出了接口链路触发器,而 6.0 YAML 中还包含温度与固件触发器。完整清单如下:
1. 接口链路中断(原型触发器,AVERAGE)
表达式:last(/Mikrotik/net.if.status[ifOperStatus.{#SNMPINDEX}])=2
and (last(/Mikrotik/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)
<>last(/Mikrotik/net.if.status[ifOperStatus.{#SNMPINDEX}],#2))=1
语义拆解:ifOperStatus = 2 表示 down(2)(IF-MIB 定义 1=up,2=down),后半段比较最近两次采集值(#1 与 #2)不相等,即"状态发生了跳变"。两者用 AND 连接,构成经典的边沿触发(状态从 up→down 才告警),避免设备上线初期或持续 down 时反复告警。5.0 分支用旧式语法实现同样的逻辑:{Mikrotik:...}.last()}=2 and {Mikrotik:...}.diff()}=1。README 中同时出现的 "Link down" 与 "Link down (LLD)" 两条即此原型在 5.x 导出格式下的对应形态。
2. 环境温度过高(AVERAGE)与过低(WARNING)
定义在温度监控项 mtxrHlTemperature 的 triggers 段:
| 触发器 | 表达式 | 优先级 |
|---|---|---|
| Temperatura Ambiente Alta >27° | last(/Mikrotik/mtxrHlTemperature)>37 |
AVERAGE |
| Temperatura Ambiente Baixa <15° | last(/Mikrotik/mtxrHlTemperature)<25 |
WARNING |
注意表达式阈值(37 / 25)与触发器名称中的(27 / 15)不一致,这是作者在描述中明确解释的设计取舍:CCR 系列机型的板载温度传感器存在约 +10°C 的测量偏差,因此用"实测值 37°C 对应环境 27°C"来修正。作者特别建议:如果你的设备没有该偏差(或偏差不同),请改用计算型监控项(Calculated item)对原始读数做差值修正后再套用触发器阈值,避免误报。
3. 固件等待升级(INFO)
表达式:last(/Mikrotik/mtxrFirmwareUpgradeVersion,#2)<>last(/Mikrotik/mtxrFirmwareVersion,#2)
mtxrFirmwareUpgradeVersion(待升级版本)与 mtxrFirmwareVersion(当前活动版本)连续两次采集不一致,即认为存在可升级的新固件,以 INFO 级别提示。这是把 RouterOS 的"固件升级包已上传但未生效"状态转化为可告警信号的低成本手段。
内置图形:开箱即用的可视化
模板预置了 4 个图形([YAML 的 graphs 与 graph_prototypes 段),导入后无需手工建图:
| 图形名称 | 内容 | 关键配置 |
|---|---|---|
| CPU Load | 整体 CPU 负载曲线 | 渐变线(CCCC00),宽 300,Y 轴固定 |
| Temperatura Ambiente | 温度曲线 | Y 轴范围固定 10~50°C(yaxismin: '10'、yaxismax: '50'),渐变线(880088) |
| Uso de Memoria | 内存使用量 + 内存总量 | 使用量渐变线(00BB00,MAX 聚合)、总量粗线(BB0000,GRAPH_SUM),隐藏工作时间与触发器 |
| Interface {#IFNAME}({#IFALIAS}): Network traffic(原型) | 每接口流量总览 | 进/出流量为渐变线(1A7C11 / 2774A4,左轴 bps),错误与丢弃为虚线(F63100 / A54F10 / FC6EA3 / 6C59DC,右轴) |
其中接口流量图原型是典型的组合视图:左轴看吞吐(Bytes In/Out),右轴叠加错误与丢弃速率,一张图即可同时判断"链路是否拥堵"与"链路是否劣化"。温度图固定 Y 轴 10~50°C,配合前述触发器,环境异常一眼可辨。
部署步骤与使用建议
结合仓库 README.md 的通用使用流程与本文模板特性,部署路径如下:
- 导入模板:在 Zabbix Web 界面 Configuration → Templates → Import,选择与你 Zabbix 主版本匹配的分支文件:
- 确认 RouterOS 已启用 SNMP:
/snmp set enabled=yes community=<你的团体名>,并保证 Zabbix Server/Proxy 与设备网络可达、UDP 161 端口畅通。 - 创建主机并关联模板:在主机配置中填写 MikroTik 管理 IP,链接
Mikrotik模板;若设备团体名与模板默认值sksnmp不同,在主机宏层面覆盖{$SNMP_COMMUNITY}。 - 核对发现结果:等待首个 LLD 周期(接口 60s、存储 1h、CPU 3s)后,检查 Monitoring → Latest data,确认接口、磁盘、CPU 核原型均已生成。
- 按需调整:
- 修改命名列表
Network interfaces for discovery控制纳入监控的接口; - 若设备无温度偏差,为
mtxrHlTemperature建计算项修正阈值; - 大规模场景下调大
system.discoverycpu的 3s 轮询间隔,减轻设备 SNMP 负担。
- 修改命名列表
小结
template_monitoramento_de_mikrotik_sem_interface_pppoe 是一套结构清晰、可直接落地的 RouterOS SNMP 监控模板:15 个常规监控项覆盖系统身份、资源、健康与固件信息,3 条 LLD 规则自动纳管接口/存储/多核 CPU,触发器兼顾链路抖动、温区偏差与固件升级提示,预置图形开箱即用。唯一的部署前提是正确设置 {$SNMP_COMMUNITY} 宏并启用设备 SNMP。对于需要快速建立 MikroTik 设备"系统级体检"的中小型网络,该模板是一个零 Agent、低开销的务实选择;若需进一步覆盖 PPPoE 客户端统计等业务维度,可在此基础上参考仓库 Network_Devices/Mikrotik 目录下的其他模板(如 template_quantidade_de_clientes_pppoe)做组合扩展。