【免费下载链接】community-templates
Zabbix Community Templates repository
本指南围绕 Zabbix 社区模板仓库中的Cisco_1900模板展开,这是一套面向 Cisco 1900 系列路由器的轻量级监控方案,通过 ICMP 简单检查与 SNMP 接口指标,覆盖设备可用性、网络延迟、接口出入流量、端口速率、MTU 与运行时长等关键状态。读完本文,你将掌握该模板的完整监控项清单、预处理换算原理、图形配置方式,以及如何在 Zabbix 5.0/5.4/6.0 中导入并应用到真实路由器上。
模板概览:面向 Cisco 1900 的轻量监控方案
Cisco_1900 模板由社区作者 Magno Monte Cerqueira("magnopeem")编写并提交到 Zabbix 官方社区模板仓库,用于监控 Cisco 1900 系列路由器。模板本体位于 Network_Devices/Cisco/template_cisco_1900/6.0/template_cisco_1900.yaml,说明文档为 Network_Devices/Cisco/template_cisco_1900/6.0/README.md。
从模板导出的 YAML 元数据可以看到:
- 模板名:
Cisco_1900,UUID 为5a93dad592894388948614425ea69bf5; - 归属分组:
Templates; - 导出版本:
6.0,导出时间为2021-11-21T21:18:07Z; - 模板未使用任何宏(Macros)、模板链接(Template links)、发现规则(Discovery rules)和触发器(Triggers),结构非常精简。
模板的 Overview 中明确列出了监控目标:可用性(Disponibilidade)、延迟(Latencia)、输入/输出流量(Tráfego de entrada/saida)、端口速率(Velocidade da Porta)、MTU,并在注释中说明"这是一个用于 Cisco 1900 路由器的模板,欢迎大家补充更多信息"。README 提到的"Pacotes de entrada / Pacotes de Saida(出入数据包)"在实际模板中是通过 IF-MIB 的 octet 计数器(字节数)实现的,即统计的是流量而非包计数,这一点在使用时需要注意。
监控项清单:11 个 Item 全覆盖
模板共定义 11 个监控项(Item),其中 2 个为 ICMP 简单检查,9 个为 SNMP agent 检查。下表完整列出各监控项的配置(名称保留模板中的葡萄牙语原文,并给出中文说明):
| 监控项名称(模板原文) | 中文含义 | 类型 | Key / OID | 更新间隔 | 单位 | 预处理 |
|---|---|---|---|---|---|---|
| Disponibilidade | 可用性(存活探测) | Simple check | icmpping | 30s | - | 无 |
| Latencia | 网络延迟 | Simple check | icmppingsec | 60s | s | 无 |
| Tempo Ligado | 设备运行时长 | SNMP agent | sysUpTime(SNMPv2-MIB::sysUpTime.0) | 60s | uptime | MULTIPLIER × 0.01 |
| Velocidade Porta GigaEthernet 0/0 | Gi0/0 端口速率 | SNMP agent | ifSpeed.1(IF-MIB::ifSpeed.1) | 30s | - | MULTIPLIER × 1 |
| Velocidade Porta GigaEthernet 0/1 | Gi0/1 端口速率 | SNMP agent | ifSpeed.2(IF-MIB::ifSpeed.2) | 30s | - | MULTIPLIER × 1 |
| Velocidade Porta GigaEthernet 0/0 MTU | Gi0/0 端口 MTU | SNMP agent | ifMtu.1(IF-MIB::ifMtu.1) | 30s | b | MULTIPLIER × 1000000 |
| Velocidade Porta GigaEthernet 0/1 MTU | Gi0/1 端口 MTU | SNMP agent | ifMtu.2(IF-MIB::ifMtu.2) | 30s | b | MULTIPLIER × 1000000 |
| Tráfego de Entrada GigabitEthernet 0/0 | Gi0/0 入口流量 | SNMP agent | ifInOctets.1(IF-MIB::ifInOctets.1) | 60s | bps | CHANGE_PER_SECOND + MULTIPLIER × 8 |
| Tráfego de Entrada GigabitEthernet 0/1 | Gi0/1 入口流量 | SNMP agent | ifInOctets.2(IF-MIB::ifInOctets.2) | 60s | bps | CHANGE_PER_SECOND + MULTIPLIER × 8 |
| Tráfego de Saida GigabitEthernet 0/0 | Gi0/0 出口流量 | SNMP agent | ifOutOctets.1(IF-MIB::ifOutOctets.1) | 60s | bps | CHANGE_PER_SECOND + MULTIPLIER × 8 |
| Tráfego de Saida GigabitEthernet 0/1 | Gi0/1 出口流量 | SNMP agent | ifOutOctets.2(IF-MIB::ifOutOctets.2) | 60s | bps | CHANGE_PER_SECOND + MULTIPLIER × 8 |
可以看到,模板针对 Cisco 1900 路由器的两个千兆接口GigabitEthernet 0/0与GigabitEthernet 0/1分别建立了独立监控项,索引 1、2 对应 IF-MIB 中两个接口的 ifIndex。各监控项还带有Application标签(如Disponibilidade、Latencia、Tráfego de Entrada、Tráfego de Saida、MTU、Velocidade Porta),便于在监控页面中按应用维度筛选归类。
采集机制详解:ICMP 与 SNMP 双通道
可用性与延迟:ICMP 简单检查
模板使用 Zabbix 内置的 ICMP 简单检查承担存活探测与延迟测量:
icmpping:每 30 秒探测一次,返回 1/0 表示设备可达/不可达,用于刻画可用性曲线;icmppingsec:每 60 秒测量一次往返时间,单位s,用于观察网络延迟的波动。
这两类检查不依赖目标设备开启 SNMP,只需 Zabbix server/proxy 能通过 ICMP 访问路由器管理地址即可。需要注意的是,ICMP 简单检查需要在 Zabbix 编译/运行时具备 ICMP ping 支持,并且 Zabbix server 进程需以能发起 ICMP 请求的权限运行。
接口流量与端口属性:SNMP 与 IF-MIB
流量与端口属性类监控项均走 SNMP agent 采集,OID 全部取自标准IF-MIB(RFC 2863 定义的接口 MIB),因此不依赖 Cisco 私有 MIB,通用性很强:
IF-MIB::ifInOctets.<n>:接口 n 累计接收的字节数(计数器);IF-MIB::ifOutOctets.<n>:接口 n 累计发送的字节数(计数器);IF-MIB::ifSpeed.<n>:接口 n 当前速率,单位为 bits per second(如 1 Gbps 口返回 1000000000);IF-MIB::ifMtu.<n>:接口 n 的最大传输单元(MTU),单位字节。
模板要求被监控设备开启 SNMP agent(通常为 SNMPv2c 或 v1),并在 Zabbix 主机配置中提供正确的 SNMP community。该模板在 YAML 中并未硬编码 community,而是沿用 Zabbix 标准宏{$SNMP_COMMUNITY}的默认机制(模板未定义自有宏,因此直接使用全局/主机级默认值)。
运行时长:SNMPv2-MIB sysUpTime
Tempo Ligado项采集SNMPv2-MIB::sysUpTime.0,单位为"百分之一秒"(time ticks)。模板通过预处理将其换算为秒后以uptime单位展示,Zabbix 会自动将其渲染为"X days, X hours..."的人类可读格式。
预处理链路:从原始计数器到可读指标
模板的精髓在于对原始 SNMP 计数器的预处理换算,在 template_cisco_1900.yaml 中可以逐项核对。下面以入口流量项为例:
- name: 'Tráfego de Entrada GigabitEthernet 0/0' type: SNMP_AGENT snmp_oid: 'IF-MIB::ifInOctets.1' key: ifInOctets.1 delay: '60' units: bps preprocessing: - type: CHANGE_PER_SECOND parameters: - '' - type: MULTIPLIER parameters: - '8'流量:从字节计数器到 bps
ifInOctets/ifOutOctets返回的是累计字节计数,直接展示没有意义,必须经过两步换算:
- CHANGE_PER_SECOND:对计数器取两次采集间的差值并除以时间间隔,得到每秒变化的字节数(字节/秒);
- MULTIPLIER × 8:将字节/秒乘以 8 转换为比特/秒,配合
units: bps得到标准的流量速率值。
这正是"接口流量 = 计数器变化率 × 8"的经典换算公式,最终落库单位为bps,可直接用于带宽占用分析。
MTU:百万倍缩放
MTU 项(如ifMtu.1)使用MULTIPLIER × 1000000的预处理,单位标记为b。以典型以太网 MTU 1500 字节为例,原始值 1500 经缩放后得到 1,500,000,000,其意图是把字节单位的 MTU 数值放大到与速率量级一致的展示尺度(作者在 README 中称之为"Velocidade em MTU")。使用时若觉得数值过于夸张,可在导入后自行调整该预处理系数。
sysUpTime:百分之一秒到秒
sysUpTime项使用MULTIPLIER × 0.01:将 SNMP 返回的 time ticks(百分之一秒)换算为秒,再交由units: uptime做人类可读格式化。这是 Zabbix 中处理 sysUpTime 的常见做法,可以避免原始 ticks 数值在图形上难以解读。
图形配置:7 张预置图表
模板预置了 7 张图形,导入后即可直接查看可视化效果:
| 图形名称 | 展示内容 | 线条样式 / 颜色 |
|---|---|---|
| Disponibilidade | 可用性(icmpping) | GRADIENT_LINE,绿色1A7C11 |
| Latencia | 延迟(icmppingsec) | GRADIENT_LINE,绿色1A7C11 |
| Tempo Ligado | 运行时长(sysUpTime) | GRADIENT_LINE,绿色1A7C11 |
| Trafego de Entrada | Gi0/0 与 Gi0/1 入口流量 | BOLD_LINE,1A7C11与0000EE双线 |
| Tráfego de Saida | Gi0/0 与 Gi0/1 出口流量 | BOLD_LINE,1A7C11与0000EE双线 |
| Velocidade Porta | 两端口速率(ifSpeed) | BOLD_LINE,1A7C11与0000EE双线 |
| Velocidade Porta MTU | 两端口 MTU(ifMtu) | BOLD_LINE,1A7C11与0000CC双线 |
流量、速率与 MTU 类图形将两个接口绘制在同一张图上(通过graph_items的sortorder控制顺序),便于横向对比 Gi0/0 与 Gi0/1 的行为差异。
部署与使用步骤
按照仓库根目录 README.md 的使用说明,将该模板接入监控环境分为三步:
- 导入模板:在 Zabbix Web 界面中进入Data collection → Templates,点击 Import,选择 template_cisco_1900.yaml 上传导入。Zabbix 会自动解析其中的 items、graphs 与标签定义。
- 配置主机与接口:为 Cisco 1900 路由器创建主机,添加 SNMP 接口(地址、端口 161、版本 v2c/v1),并设置正确的 SNMP community(对应
{$SNMP_COMMUNITY}宏值);同时确保 Zabbix server 与该地址之间 ICMP 可达,否则icmpping/icmppingsec两项会处于 Unsupported 或异常状态。 - 链接模板:在主机配置中链接
Cisco_1900模板,等待一个更新周期(最长为 60 秒)后即可在监控项、最新数据与图形页面看到采集结果。
模板无需额外的外部脚本或 UserParameter,纯靠 ICMP 与 SNMP 标准协议工作,部署成本低、可移植性好。
版本兼容:5.0 / 5.4 / 6.0 三套文件
仓库为模板维护了三个 Zabbix 版本目录,内容完全一致,只是导出格式不同:
- Network_Devices/Cisco/template_cisco_1900/5.0/template_cisco_1900.xml —— XML 格式,适用于 Zabbix 5.0,导出时间为
2021-11-25T12:40:16Z; - Network_Devices/Cisco/template_cisco_1900/5.4/template_cisco_1900.yaml —— YAML 格式,适用于 Zabbix 5.4;
- Network_Devices/Cisco/template_cisco_1900/6.0/template_cisco_1900.yaml —— YAML 格式,适用于 Zabbix 6.0。
5.4 与 6.0 的 YAML 文件在监控项、预处理与图形定义上完全一致,UUID 也相同,说明模板自导出后未做过功能性改动。使用时请选择与你的 Zabbix 主版本匹配的文件导入,以免出现兼容性警告。
扩展方向与注意事项
作者在 README 中明确欢迎社区继续补充信息,结合模板现状可以梳理出以下扩展点与使用注意:
- 尚无触发器(Triggers):模板未定义任何告警规则。实际使用中建议自行补充,例如:
icmpping=0时触发"设备不可达"告警、icmppingsec超过阈值触发"延迟过高"告警、接口流量长期为 0 触发"链路空闲"告警等; - 尚无发现规则(Discovery):模板手工指定了 Gi0/0、Gi0/1 两个接口。若路由器接口数量较多或可能变化,可改用
IF-MIB::ifDescr/ifName的 LLD 发现规则,配合{#IFNAME}宏自动生成各接口监控项; - 未覆盖的设备维度:CPU 利用率、内存占用、温度与电源状态等 Cisco 设备常见监控点不在本模板范围内,可参考仓库 Network_Devices/Cisco 目录下其他模板(如 template_cisco_memory_and_cpu、template_cisco_total)进行组合补充;
- README 与实现的口径差异:README 提到监控"Pacotes de entrada/saida(出入数据包)",但模板实际采集的是
ifInOctets/ifOutOctets字节计数,即流量而非包数;如需包统计可自行添加IF-MIB::ifInUcastPkts、ifOutUcastPkts等 OID。
总而言之,Cisco_1900 是一套结构清晰、开箱即用的轻量级路由器监控模板,尤其适合只需要"存活 + 延迟 + 双接口流量 + 端口属性"的场景;在此基础上结合 LLD 与触发器稍作扩展,即可构建一套完整的 Cisco 1900 运维监控方案。
【免费下载链接】community-templates
Zabbix Community Templates repository
相关推荐
agentic-awesome-skills 稳定技能清单(Stable Skills Manifest v1):自定义宿主集成与懒加载接入指南
agentic awesome skills 稳定技能清单(Stable Skills Manifest v1):自定义宿主集成与懒加载接入指南 导读 本指南围
Zabbix 社区模板实战:基于 SNMP 的 Mikrotik RouterOS 全维度监控模板解析与部署指南
Zabbix 社区模板实战:基于 SNMP 的 Mikrotik RouterOS 全维度监控模板解析与部署指南 导读 本文围绕 Zabbix Communit
终极显卡显存检测指南:memtest_vulkan帮你轻松排查GPU故障
终极显卡显存检测指南:memtest_vulkan帮你轻松排查GPU故障 想知道你的显卡显存是否健康吗?担心超频后硬件不稳定?今天我要介绍一款超实用的开源工具—
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考