Zabbix Community Templates:基于 EtherLike-MIB 的 SNMPv3 模块化双工状态监控模板解析
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.0 版本遗留的 bug(README 中明确标注 "UPDATED: There was a bug in version 1.0");
- 将 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")。
方式一:单独使用
- 在 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);
- 在主机上定义宏
{$SECURITY_NAME}、{$AUTH_PASSPHRASE}、{$PRIV_PASSPHRASE}(或在模板级别统一定义); - 在主机配置中设置 SNMP 接口,安全级别与宏值对齐(SHA / AES128);
- 将模板链接到主机,等待发现规则(默认 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 等企业级交换机的分层监控体系。