Zabbix Community Templates:基于 EtherLike-MIB 的 SNMPv3 模块化双工状态监控模板解析

原创2026-10-16 12:37:082,332 阅读

Zabbix Community Templates:基于 EtherLike-MIB 的 SNMPv3 模块化双工状态监控模板解析

本文以 Zabbix 社区模板仓库(community-templates)中的 Module EtherLike-MIB SNMPv3 模块为核心,完整讲解如何通过 SNMPv3 低级别自动发现(LLD)采集交换机端口双工模式(duplex)状态,并在端口意外落入半双工(half-duplex)时产生告警。读完本文,你将掌握该模块的发现规则 OID 组合方式、三个 SNMPv3 安全宏的配置方法、值映射(valuemap)与触发器的实现细节,以及它在 HP / Aruba 企业级交换机监控方案中的挂载方式。

模板定位:为 SNMPv2 模板补齐 SNMPv3 能力的模块化补丁

Module EtherLike-MIB SNMPv3 位于仓库的 Network_Devices/Generic 目录,是一类"模块(Module)"型模板——它本身不追求自成一体,而是作为子模板链接到宿主模板(如 Template Net HP 和 Aruba Enterprise Switch SNMPv3)之上,专门负责以太网链路双工状态的采集与告警。

从模板说明(5.4/README.md)可以看到,该模板脱胎于 Ville Leinonen(hacknetwork.org)发布的 EtherLike-MIB SNMPv2 模板 1.1 版,社区作者在其基础上做了两项关键工作:

  1. 修复 1.0 版本遗留的 bug(README 中明确标注 "UPDATED: There was a bug in version 1.0");
  2. 将 SNMP 轮询从 v2c 迁移到 v3,并新增了三个 SNMPv3 安全相关的用户宏。

模板本身不包含任何宏链接(Macros used 为空)和模板链接(Template links 为空),所有配置都集中在发现规则、采集项原型和触发器原型三块,属于典型的"轻量级功能模块"。仓库中与之配套的还有同目录下的 template_module_interfaces_snmpv3(IF-MIB 接口流量/状态模块)和 template_module_generic_snmpv3(通用 SNMPv3 模块),三者共同构成一套 SNMPv3 化的交换机监控模块族。

SNMPv3 安全配置:三个用户宏与 SHA/AES128 约定

SNMPv3 相比 v2c 引入了基于用户的安全模型(USM),轮询时需要提供用户名、认证口令与加密口令。该模板通过在主机或模板级定义三个宏来完成这一对接,具体如下:

宏 含义
{$SECURITY_NAME} SNMPv3 用户名(Username)
{$AUTH_PASSPHRASE} 认证口令(Authentication password,即 authpass)
{$PRIV_PASSPHRASE} 加密口令(Encryption password,即 privpass)

模板说明同时给出了协议约定:认证算法使用 SHA,加密算法使用 AES128。这意味着在被监控交换机上配置 SNMPv3 用户时,应使用 authNoPriv 或 authPriv 安全级别并指定 SHA/AES128,才能与 Zabbix 侧的宏取值保持一致。在 Zabbix 前端配置主机时,可将这三个宏直接挂在主机级别,也可以在一组同型号交换机的主机模板上统一赋值,从而避免逐台重复填写。

以常见的 Cisco IOS 交换机为例,设备端与之对应的典型配置思路是创建 SHA/AES 用户并赋予只读视图;Zabbix 侧则只需保证宏值(用户名、口令、加密口令)与设备端完全一致即可完成握手。需要注意的是,SNMPv3 宏属于敏感信息,建议为监控单独建立低权限只读用户。

发现规则:一条 OID 如何驱动 EtherLike-MIB 双工 LLD

该模板的核心发现规则定义在 5.4/template_module_etherlike-mib_snmpv3.yaml(6.0 版本内容一致),其完整定义为:

  • 名称:EtherLike-MIB Discovery
  • 类型:SNMP agent
  • 键值(key):net.if.duplex.discoveryV3
  • 更新间隔:1h
  • SNMP OID:
    discovery[{#SNMPVALUE},1.3.6.1.2.1.10.7.2.1.19,{#IFOPERSTATUS},1.3.6.1.2.1.2.2.1.8,{#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]
    

这条 discovery[...] 是 Zabbix 的多 OID 低级别自动发现语法:第一个宏 {#SNMPVALUE} 对应索引 OID,后续每对 宏, OID 表示以相同索引额外抓取的宏变量。逐项拆解如下:

OID 所属 MIB 表 宏 含义
1.3.6.1.2.1.10.7.2.1.19 EtherLike-MIB dot3StatsTable {#SNMPVALUE} dot3StatsDuplexStatus,端口当前双工模式
1.3.6.1.2.1.2.2.1.8 IF-MIB ifTable {#IFOPERSTATUS} ifOperStatus,端口操作状态
1.3.6.1.2.1.31.1.1.1.18 IF-MIB ifXTable {#IFALIAS} ifAlias,端口别名
1.3.6.1.2.1.31.1.1.1.1 IF-MIB ifXTable {#IFNAME} ifName,端口名称
1.3.6.1.2.1.2.2.1.2 IF-MIB ifTable {#IFDESCR} ifDescr,端口描述

发现结果随后经过一个 AND 过滤器(filter)收敛,只有同时满足以下两个条件的端口才会被纳入监控:

  • {#IFOPERSTATUS} 等于 1:即接口操作状态为 up(1),保证只监控真正在线的链路;
  • {#SNMPVALUE} 匹配正则 (2|3):即 dot3StatsDuplexStatus 的值为 2(halfDuplex)或 3(fullDuplex),排除值为 1(unknown,无法确定双工模式)的接口。

由于 dot3StatsTable 与 ifTable / ifXTable 使用相同的接口索引(ifIndex),各宏在同一索引上对齐,从而实现了"从 EtherLike-MIB 取双工值、从 IF-MIB 取端口身份信息"的跨表关联。这部分实现同时体现在 5.0/template_module_etherlike-mib_snmpv3.xml 中,两个版本 OID 与过滤条件完全一致。

采集项原型:Duplex status 与值映射

发现规则之下只有一个采集项原型,定义于同一 YAML 文件中:

  • 名称:Interface {#IFNAME}({#IFALIAS}): Duplex status
  • 类型:SNMP agent
  • OID:1.3.6.1.2.1.10.7.2.1.19.{#SNMPINDEX}(dot3StatsDuplexStatus 按发现出的端口索引取值)
  • 键值:net.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}]
  • 更新间隔:1m
  • 历史数据保留:7d
  • 标签(Tag):Application: Interface {#IFNAME}({#IFALIAS})

采集值通过名为 EtherLike-MIB::dot3StatsDuplexStatus 的值映射(valuemap)翻译成可读文本,映射关系如下:

原始值 映射文本
1 unknown
2 halfDuplex
3 fullDuplex

也就是说,Zabbix 中保存的仍是数值(1/2/3),展示层会显示为 unknown / halfDuplex / fullDuplex。依据 IEEE 802.3 标准(RFC 定义中引用 30.3.1.1.32, aDuplexStatus),dot3StatsDuplexStatus 反映 MAC 实体当前的操作模式:unknown 表示当前无法确定双工模式;当接口不支持自协商或未启用自协商时,双工模式由 ifMauDefaultType 控制;当支持并启用了自协商时,由 ifMauAutoNegAdvertisedBits 控制。该对象与 ifMauType 信息冗余,但好处是管理应用无需枚举 ifMauType 的全部可能取值即可判断端口双工状态——这也是模板选用该 OID 的原因。

在 5.0 的 XML 版本中,该采集项还挂有 Network interfaces 应用(application)及 Interface {#IFNAME}({#IFALIAS}) 应用原型;5.4 / 6.0 的 YAML 版本则改用标签(tag)体系组织,体现了 Zabbix 版本演进中"应用 → 标签"的迁移痕迹。

触发器原型:半双工端口告警

模板包含一个触发器原型,直接命中网络运维最常见的物理层问题——端口降级为半双工:

  • 名称:Interface {#IFNAME}({#IFALIAS}): In half-duplex mode
  • 表达式(5.4 / 6.0 写法):
    last(/Module EtherLike-MIB SNMPv3/net.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}])=2
    
  • 恢复表达式:无(手工关闭或等端口恢复到 fullDuplex 后触发条件自动不成立)
  • 优先级:warning(警告)
  • 描述:Please check autonegotiation settings and cabling(请检查自协商设置与线缆)

触发逻辑非常直接:只要某端口最新采集到的 dot3StatsDuplexStatus 等于 2(halfDuplex),即触发警告。由于 1.0 版本存在 bug,README 特别标注了修复说明;5.0 XML 中该表达式写作相对形式 {last()}=2,5.4 起改为包含完整模板路径的 last(/Module EtherLike-MIB SNMPv3/...) 形式,这是 Zabbix 表达式语法在不同版本间的规范化差异。

从运维角度,半双工通常意味着:线缆质量差、单根线缆中一对线断开、或对端设备强制双工模式不匹配导致自协商失败。告警描述中"检查自协商设置与线缆"正是针对这些典型根因的排障指引。值得说明的是,该模板只监控"当前是否半双工",并不追踪双工模式的历史变化;若需要"全双工 → 半双工"的降级事件告警,可结合历史数据自行扩展触发器。

部署方式:单独挂载与模块化组合

该模板既可作为独立模板直接链接到主机,也可作为子模板链接到宿主模板(README 中明确说明 "Linked for Template Net HP and Aruba Enterprise Switch SNMPv3, but works also individually")。

方式一:单独使用

  1. 在 Zabbix 前端进入 Data collection → Templates,点击 Import,导入对应版本的 YAML 文件(Zabbix 5.4 用 5.4/template_module_etherlike-mib_snmpv3.yaml,6.0 用 6.0/template_module_etherlike-mib_snmpv3.yaml,5.0 用 5.0/template_module_etherlike-mib_snmpv3.xml);
  2. 在主机上定义宏 {$SECURITY_NAME}、{$AUTH_PASSPHRASE}、{$PRIV_PASSPHRASE}(或在模板级别统一定义);
  3. 在主机配置中设置 SNMP 接口,安全级别与宏值对齐(SHA / AES128);
  4. 将模板链接到主机,等待发现规则(默认 1h 更新)完成端口枚举,即可在 Latest data 中看到各端口的 Duplex status 采集项。

方式二:作为模块挂载到宿主模板

与仓库中同族的 template_module_interfaces_snmpv3(见 Network_Devices/Generic/template_module_interfaces_snmpv3/5.4/README.md)一样,本模块设计为可链接进 "Template Net HP / Aruba Enterprise Switch SNMPv3" 等宿主模板:宿主模板负责发现并纳管主机,模块模板负责补充特定的指标维度。这种方式下只需在宿主模板统一配置 SNMPv3 宏,即可实现对整批交换机的一键监控,且模块可以随时解绑而不影响宿主模板的其他指标。

版本对照与文件布局

仓库中该模板按 Zabbix 大版本分目录维护,三个版本的技术内容完全等价,仅导出格式与表达式写法不同:

目录 导出格式 说明
5.0 XML 使用应用/应用原型,触发器表达式为相对写法 {last()}=2
5.4 YAML 使用标签体系,表达式为 last(/Module EtherLike-MIB SNMPv3/...)=2
6.0 YAML 与 5.4 结构一致,适用于 Zabbix 6.0

三个版本的发现规则、OID、值映射与触发器逻辑均保持一致,导入时应根据自身 Zabbix 服务端版本选择对应目录下的文件,避免因导出版本不匹配导致导入失败。

小结

Module EtherLike-MIB SNMPv3 是一个小而精的交换机监控模块:它借助 Zabbix 多 OID LLD 将 EtherLike-MIB 的双工状态与 IF-MIB 的端口身份信息绑定,通过三个宏完成 SNMPv3 认证,并以一个 dot3StatsDuplexStatus 采集项加一个 half-duplex 警告触发器闭环了"采集 → 映射 → 告警"的完整链路。对于需要以 SNMPv3 安全方式监控大量以太网端口双工状态的场景,该模板既可独立使用,也可与 template_module_interfaces_snmpv3 等模块组合,快速构建起面向 HP / Aruba 等企业级交换机的分层监控体系。

登录后查看全文
community-templates