Zabbix 社区模板实战:基于 SNMP 无代理监控 MikroTik 路由器的全维度方案(CPU/内存/磁盘/接口/温压/固件)

原创2026-10-17 23:48:312,334 阅读

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 CPU LLD)
  • 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. 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。

  2. 预处理 ×1024 的缘由:hrStorageSize/hrStorageUsed 返回的单位是 hrStorageAllocationUnits(对 RouterOS 而言通常是 1KB 的倍数),乘以 1024 后换算为字节(B),保证后续磁盘/内存数据以 B 为单位展示。

  3. 温度与电压的 ×0.1:MikroTik 健康传感器在 SNMP 中返回的是"十分之一单位"的整数值,乘以 0.1 后还原为真实摄氏度(C)与伏特(V)。例如原始值 370 表示 37.0°C。

  4. uptime 的 ×0.01:sysUpTime 的 TimeTicks 单位为百分之一秒,乘以 0.01 后转成秒,配合 units: uptime 让 Zabbix 自动格式化为「Xd Yh Zm」风格。

  5. 间隔分层设计:变化快的指标轮询快(CPU Load 30s、内存使用 30s、温度/电压 1m、DHCP 租约 1m),变化慢的指标轮询慢(总内存 1h、固件/软件 ID/系统名 10m)。这既是合理的采集节奏,也能显著降低对低端 RouterBoard 的 SNMP 压力。

  6. 历史与趋势保留策略:多数数值型监控项设置了 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 的通用使用流程与本文模板特性,部署路径如下:

  1. 导入模板:在 Zabbix Web 界面 Configuration → Templates → Import,选择与你 Zabbix 主版本匹配的分支文件:
  2. 确认 RouterOS 已启用 SNMP:/snmp set enabled=yes community=<你的团体名>,并保证 Zabbix Server/Proxy 与设备网络可达、UDP 161 端口畅通。
  3. 创建主机并关联模板:在主机配置中填写 MikroTik 管理 IP,链接 Mikrotik 模板;若设备团体名与模板默认值 sksnmp 不同,在主机宏层面覆盖 {$SNMP_COMMUNITY}。
  4. 核对发现结果:等待首个 LLD 周期(接口 60s、存储 1h、CPU 3s)后,检查 Monitoring → Latest data,确认接口、磁盘、CPU 核原型均已生成。
  5. 按需调整:
    • 修改命名列表 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)做组合扩展。

登录后查看全文
community-templates