Zabbix 监控 MikroTik 队列流量:Mikrotik-QUEUE 模板的 LLD 发现与速率换算原理
发布时间:2026/10/17 2:27:43 锦皓数字建站

【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载导读本文围绕 Zabbix 社区模板仓库中的Mikrotik-QUEUE模板展开该模板通过 SNMP 自动发现LLD采集 MikroTik RouterOS 设备上所有 Simple Queue 的入向与出向流量并自动生成每队列的实时速率折线图是无需登录设备、纯 SNMP 轮询的轻量监控方案。读完本文你将掌握该模板的 OID 结构、发现规则与采集项原型、速率换算CHANGE_PER_SECOND × 8的底层原理以及如何在 Zabbix 5.4 中导入并挂载到 MikroTik 主机上完成队列流量图形化监控。模板概述为 MikroTik 队列流量绘图而生Mikrotik-QUEUE 是收录于 community-templates 仓库Network_Devices/Mikrotik目录下的一款小型专用模板5.4 说明文档其官方描述为zabbix template for graphing queue traffic on mikrotik devices即为 MikroTik 设备上的队列流量提供绘图能力。该模板面向 RouterOS 的 Simple Queue简单队列场景核心思路是利用 SNMP 对 MikroTik 私有 MIB 中的队列计数器表做低密度轮询再通过 Zabbix 预处理把累计计数器换算为每秒速率最终以图形方式呈现每个队列的流量曲线。该模板同时提供 5.0、5.4、6.0 三个版本分别在 5.0 XML、5.4 YAML 与 6.0 YAML 中分发三者的采集逻辑与 OID 完全一致仅在文件格式与宏变量命名上存在差异可平滑迁移。模板资产总览极简结构聚焦单点能力从 5.4 README 的资产清单可以看到该模板刻意保持极简资产类别内容Macros used无模板不依赖任何宏Template links无不链接其他模板Discovery rules1 条QueuesItems collected2 个采集项原型Queue $1 (IN)、Queue $1 (OUT)Triggers无模板不内置任何告警触发器这种设计意味着该模板只负责采集 出图不负责告警。如果你需要针对某队列速率超限触发告警需要在模板或主机层面自行补充触发器表达式。从 6.0 YAML 可以看出采集项均携带Application: Queues标签方便在 Zabbix 前端按应用过滤与归类。发现规则LLD枚举设备上的全部队列模板中的唯一发现规则名为Queues类型为SNMP agent其定义如下属性值名称Queues类型SNMP agentKey.1.3.6.1.4.1.14988.1.1.2.1.1.2更新间隔30 秒从 5.4 YAML 中可以看到该规则在导出文件中的完整形态discovery_rules: - name: Queues type: SNMP_AGENT snmp_oid: discovery[{#SNMPVALUE},1.3.6.1.4.1.14988.1.1.2.1.1.2] key: .1.3.6.1.4.1.14988.1.1.2.1.1.2 delay: 30这里有两个值得注意的实现细节OID 归属1.3.6.1.4.1.14988是 MikroTik 的私有企业号14988.1.1.2对应 MikroTik 私有 MIB 中的队列表。该发现规则直接对队列表内的名称列.1.1.2子节点做 SNMP walk从而枚举出设备上配置的全部 Simple Queue并生成{#SNMPVALUE}宏供后续采集项原型引用。发现机制Zabbix 的 SNMP LLD 使用discovery[{#SNMPVALUE},OID]形式将 OID 的每个实例值填充进{#SNMPVALUE}即队列名称文本同时{#SNMPINDEX}保留该实例的数字索引。更新间隔 30 秒意味着新增/删除队列后最多 30 秒内即可反映到监控数据中。采集项原型入向与出向的双向速率发现规则会为每个队列动态生成两个采集项均标注LLD更新间隔为 60 秒采集项名称类型Key更新间隔单位Queue $1 (IN)SNMP agent.1.3.6.1.4.1.14988.1.1.2.1.1.8[{#SNMPVALUE}]60 秒bpsQueue $1 (OUT)SNMP agent.1.3.6.1.4.1.14988.1.1.2.1.1.9[{#SNMPVALUE}]60 秒bps其中$1由 LLD 宏{#SNMPVALUE}填充因此实际生成的采集项名称会形如Queue lan (IN)。两条原型分别轮询队列表内.1.1.8与.1.1.9两个计数器节点——按 RouterOS 私有 MIB 的队列表结构推断二者分别对应队列的累计字节计数器的两个方向IN / OUT具体字段语义请以对应 RouterOS 版本的官方 MIB 文件为准。在 5.4 YAML 中两条原型除 OID 不同外配置完全相同均包含单位bps与两步预处理。预处理链把计数器换算成每秒速率该模板的精髓在于数据预处理SNMP 计数器返回的是累计字节数而图形需要展示的是每秒速率。模板通过两级预处理完成换算见 5.4 YAMLpreprocessing: - type: CHANGE_PER_SECOND parameters: - - type: MULTIPLIER parameters: - 8两级处理的职责分别是CHANGE_PER_SECOND每秒变化量对两次轮询间的累计计数器做差分并除以时间间隔得到每秒字节数B/s。这一步把单调递增的计数器转换为可绘图的速率值其参数为空字符串表示由 Zabbix 自动按两次采集时间差计算。MULTIPLIER乘数将上一步得到的 B/s 乘以8把字节速率换算为比特速率bps。这是网络监控的惯例换算1 Byte 8 bit与采集项units: bps的定义相互呼应最终图形上展示的即为标准的 bit/s 流量曲线。需要说明的是CHANGE_PER_SECOND 依赖两次取值间的差值因此采集间隔60 秒直接决定了速率曲线的平滑度与灵敏度——间隔越长曲线越平滑对瞬时突发的敏感度越低。若需要更细粒度数据可在模板中调低delay并同步考虑设备 SNMP 轮询负载。图形原型每个队列一张独立流量图模板还定义了一个图形原型Queue {#SNMPVALUE}见 5.4 YAML随 LLD 为每个队列自动生成一张图图内包含两条渐变折线图项引用的采集项绘制方式颜色Y 轴OUT.1.3.6.1.4.1.14988.1.1.2.1.1.9[{#SNMPVALUE}]GRADIENT_LINE33FF33绿RIGHTIN.1.3.6.1.4.1.14988.1.1.2.1.1.8[{#SNMPVALUE}]GRADIENT_LINEFF33FF粉RIGHT两条曲线使用对比色绿 / 粉区分出向与入向均采用GRADIENT_LINE渐变线绘制方式聚合函数为MAX并统一挂载到右轴yaxisside: RIGHT。导入模板后打开主机 → 监测 → 图形页面即可按队列查看绿进粉出的双向流量曲线无需手工建图。在 Zabbix 5.4 中导入与使用按照仓库根 README.md 的通用流程使用步骤如下导入模板在 Zabbix 前端进入数据采集 → 模板 → 导入选择 5.4 YAML 文件导入Zabbix 5.4 使用 YAML/JSON 格式若运行 Zabbix 5.0请改用同目录的 5.0 XML。确认设备侧 SNMP 就绪在 MikroTik RouterOS 上通过WinBox或 CLI 启用 SNMP/snmp set enabledyes并为 Zabbix 服务器指定可访问的 community 字符串确保 Zabbix 能对1.3.6.1.4.1.14988企业 OID 子树执行 walk。挂载模板为主机配置Mikrotik-QUEUE模板并正确填写主机的 SNMP community、端口与接口 IP。由于模板未定义任何宏SNMP community 的配置依赖 Zabbix 主机层面的{$SNMP_COMMUNITY}宏或主机接口设置。验证数据在主机的最新数据页面确认 LLD 规则Queues正常产出队列实体、Queue xxx (IN)/(OUT)采集项有非空数值随后到图形页面查看自动生成的Queue xxx图。与 Queue Tree 模板的定位差异在同一个 Mikrotik 目录 下社区还提供了功能相邻的Mikrotik-Queue-Tree模板见 5.4 YAML。两者都基于1.3.6.1.4.1.14988.1.1.2队列家族 OID但适用场景不同可对照选择维度Mikrotik-QUEUE本文模板Mikrotik-Queue-Tree监控对象Simple Queue简单队列Queue Tree队列树含 Dropped/Packets/HCBytes 等指标发现表 OID1.3.6.1.4.1.14988.1.1.2.1.1.21.3.6.1.4.1.14988.1.1.2.2.1.2预处理CHANGE_PER_SECOND MULTIPLIER 8CHANGE_PER_SECOND丢包/包数HCBytes 额外乘 8宏依赖无{$UPDATEINT}、{$HISTORY}、{$TRENDS}内置图形每队列 1 张双向速率图每队列 Dropped / HCBytes / Packets 三张图如果你的网络以 Simple Queue 做限速与带宽管理本模板即可满足双向速率可视化需求若需要深挖 Queue Tree 的丢包与包速率指标则应转向 Queue Tree 模板。小结Mikrotik-QUEUE 是一个结构精简、目的明确的 SNMP LLD 模板一条发现规则枚举全部 Simple Queue两个采集项原型分别轮询入/出向累计字节计数器两级预处理把计数器换算为 bit/s 速率图形原型自动生成绿进粉出的双向流量图全程无宏、无触发器依赖开箱即用。对需要在 Zabbix 中快速落地 MikroTik 队列流量可视化的场景它是一个轻量且完全可复用的起点结合源码级 YAML 还可按需调整采集间隔、颜色与聚合方式实现定制化扩展。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐MikroTik 路由器队列流量监控实战:Zabbix Mikrotik-QUEUE 模板(SNMP LLD)原理与部署指南MikroTik 路由器队列流量监控实战:Zabbix Mikrotik QUEUE 模板 SNMP LLD 原理与部署指南 本篇技术指南围绕 Zabbix 社Zabbix 通过 SSH LLD 监控 MikroTik RouterOS BGP 对等体模板 Mikrotik - BGP LLD 实战指南Zabbix 通过 SSH LLD 监控 MikroTik RouterOS BGP 对等体模板 Mikrotik BGP LLD 实战指南 导读 本文围基于 SSH 与 LLD 的 MikroTik RouterOS BGP Peer 监控解读 community-templates 中的 Mikrotik - BGP LLD 模板基于 SSH 与 LLD 的 MikroTik RouterOS BGP Peer 监控解读 community templates 中的 Mikrotik上一篇CodeGeeX VS Code 插件实战指南四种模式、快捷键与提示模板深度解析下一篇微信聊天记录如何永久保存用留痕WeChatMsg的完整本地导出指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。