【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本文围绕 Zabbix Community Templates 仓库中的Module EtherLike-MIB SNMPv3模块模板展开完整讲解该模板的发现规则、监控项、触发器与 SNMPv3 凭证宏的配置方法并结合仓库内的模板源码YAML/XML 导出文件剖析其底层 OID 与过滤逻辑。读完本文你将能够在 Zabbix 5.0/5.4/6.0 环境中导入该模块将其链接到 HP、Aruba 等企业级交换机的 SNMPv3 主机上自动发现所有处于 up 状态的以太网接口并对接口降为半双工这一典型的物理链路或自协商故障发出告警。模板概述从 SNMPv2 模块升级而来的 SNMPv3 版本Module EtherLike-MIB SNMPv3是一个标准的 Zabbix模板模块Template Module位于仓库的 Network_Devices/Generic/template_module_etherlike-mib_snmpv3 目录。按模板自带的描述它是在 Ville Leinonen 发布的Template Module EtherLike-MIB SNMPv2Version 1.1基础上改造而来核心变化是将数据采集协议从 SNMPv2 迁移到 SNMPv3并新增了三个 SNMPv3 凭证宏。README 中特别注明UPDATED: There was a bug in version 1.0即 1.0 版本存在缺陷、当前版本已修复导入时应使用最新版文件。该模块的设计目标是作为模块被链接到更上层的设备模板中使用——README 明确指出它为 Template Net HP 和 Aruba Enterprise Switch SNMPv3 而设计但也可以独立使用Linked for Template Net HP and Aruba Enterprise Switch SNMPv3, but works also individually。因此它属于Templates/Modules模板组不包含主机级监控项只提供围绕 EtherLike-MIB 双工状态的一组发现规则、监控项原型与触发器原型。仓库同时提供了三个 Zabbix 版本对应的导入文件Zabbix 版本文件格式5.0template_module_etherlike-mib_snmpv3.xmlXML5.4template_module_etherlike-mib_snmpv3.yamlYAML6.0template_module_etherlike-mib_snmpv3.yamlYAML三个版本逻辑完全一致5.4 与 6.0 的 YAML 导出内容相同5.0 的 XML 除触发器表达式书写语法外也无实质差异均带zabbix_export头部标识版本与导出时间。导入方式为Zabbix Web 界面Configuration → Templates → Import选择对应版本的 XML/YAML 文件即可也可以使用zabbix API的configuration.import方法批量导入。适用场景与使用前提该模板解决的是一类非常具体的网络运维问题以太网接口工作在半双工模式。半双工往往意味着链路协商异常例如对端设备强制了某一速率/双工模式、线缆质量差、端口协商不一致会直接造成丢包、时延增大和吞吐量下降。模板通过 SNMP 轮询EtherLike-MIB中的dot3StatsDuplexStatus对象把接口当前双工模式实时采集进 Zabbix一旦发现半双工即产生 warning 级告警。使用前提均以仓库模板内容为依据设备支持 SNMPv3 且已开启模板所有监控项类型均为SNMP agent需在主机上配置 SNMPv3 接口安全级别authPriv认证协议使用SHA、加密协议使用AES128README 明确要求please use SHA and AES128设备支持 EtherLike-MIB 与 IF-MIB绝大多数企业级以太网交换机HP/Aruba、Cisco、H3C 等均支持Zabbix 5.0 及以上仓库仅提供 5.0/5.4/6.0 三种导出格式。SNMPv3 凭证宏{$SECURITY_NAME} / {$AUTH_PASSPHRASE} / {$PRIV_PASSPHRASE}SNMPv2 版本无需认证即可读取而 SNMPv3 引入了安全模型USM。该模块在升级时为此新增了三个宏README 中给出了明确含义宏含义{$SECURITY_NAME}SNMPv3 用户名Username{$AUTH_PASSPHRASE}认证口令Authentication password配合 SHA{$PRIV_PASSPHRASE}加密口令Encryption password配合 AES128需要注意的是README 的 Macros used 一节明确写着There are no macros links in this template——这三个宏并未在模板内部定义默认值它们需要在使用时于主机Host或上层模板上自行配置。在 Zabbix 中SNMPv3 凭证可以通过两种方式提供主机接口直接填写在主机配置 → 接口Interfaces中把类型选为 SNMP版本选 SNMPv3直接填写 Security name、Auth passphrase、Priv passphrase宏方式在主机宏或链接模板的宏中定义{$SECURITY_NAME}、{$AUTH_PASSPHRASE}、{$PRIV_PASSPHRASE}并把 SNMP 接口的对应字段设置为宏引用Zabbix 接口支持{$MACRO}形式。建议在主机级别维护凭证宏这样同一套 SNMPv3 凭证可被 Generic、Interfaces、EtherLike-MIB 等多个模块模板共用。发现规则EtherLike-MIB Discovery模板只有一条发现规则Discovery rule源码位于 6.0 YAML 模板 的discovery_rules段L52-L71属性值名称EtherLike-MIB Discovery类型SNMP agent键值Keynet.if.duplex.discoveryV3更新间隔1hOID见下文 discovery[] 语法其完整 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]这是 Zabbix SNMP 低级别发现LLD的discovery[]语法discovery[{#MACRO1},OID1,{#MACRO2},OID2,...]——每一对宏名 OID会在发现时被逐一 walk为每个被发现的实体生成对应的{#MACRO}值。这里共注册了 5 个自定义发现宏分别对应发现宏OIDMIB 对象含义{#SNMPVALUE}1.3.6.1.2.1.10.7.2.1.19EtherLike-MIBdot3StatsDuplexStatus接口当前双工模式{#IFOPERSTATUS}1.3.6.1.2.1.2.2.1.8IF-MIBifOperStatus接口运行状态{#IFALIAS}1.3.6.1.2.1.31.1.1.1.18IF-MIBifAlias接口别名{#IFNAME}1.3.6.1.2.1.31.1.1.1.1IF-MIBifName接口名称{#IFDESCR}1.3.6.1.2.1.2.2.1.2IF-MIBifDescr接口描述其中 OID 前缀1.3.6.1.2.1.10transmission下的7即dot3以太网2.1.19指向dot3StatsEntry.dot3StatsDuplexStatus。{#SNMPINDEX}由 Zabbix 在发现时自动生成用于后续监控项原型中拼接具体索引。发现规则还内置了过滤器filter采用AND逻辑过滤条件值含义{#IFOPERSTATUS}1仅保留运行状态为 up(1) 的接口{#SNMPVALUE}(2\|3)仅保留双工状态为已知值halfDuplex2 或 fullDuplex3的接口两条条件同时满足才纳入发现因此处于 down/unknown 状态的接口、以及双工模式无法确定unknown1的接口都会被自动排除这与发现规则描述Discovering interfaces from IF-MIB and EtherLike-MIB. Interfaces with up(1) Operational Status are discovered完全一致。更新间隔 1h 意味着新插入的网卡/模块最长一小时后才被纳入监控属于合理的 LLD 扫描节奏。监控项原型Interface {#IFNAME}({#IFALIAS}): Duplex status发现规则下定义了一个监控项原型item prototype源码见 6.0 YAML 模板 的item_prototypes段L72-L118属性值名称Interface {#IFNAME}({#IFALIAS}): Duplex status类型SNMP agentOID1.3.6.1.2.1.10.7.2.1.19.{#SNMPINDEX}键值Keynet.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}]更新间隔1m历史数据保留7d值映射EtherLike-MIB::dot3StatsDuplexStatus标签Application: Interface {#IFNAME}({#IFALIAS})监控项原型会为每个被发现的接口生成一个独立监控项名称中直接嵌入{#IFNAME}接口名与{#IFALIAS}别名例如Interface GigabitEthernet1/0/1(uplink): Duplex status便于在最新数据与仪表盘中直接识别。OID 末尾的.{#SNMPINDEX}是发现时生成的索引后缀指向具体接口的dot3StatsDuplexStatus实例。监控项绑定了值映射EtherLike-MIB::dot3StatsDuplexStatus其定义见同一 YAML 文件的valuemaps段L119-L132原始值显示值1unknown2halfDuplex3fullDuplex因此监控项虽然存储的是整数界面和图表上会直接展示为unknown / halfDuplex / fullDuplex三种可读状态。这三档取值正是 IEEE 802.3 标准 30.3.1.1.32aDuplexStatus定义的枚举模板的监控项描述中完整引用了该标准条款并解释了设计背景dot3StatsDuplexStatus直接反映 MAC 实体当前运行的双工模式与ifMauType信息冗余但可以让管理应用不必了解ifMauType的全部取值就能直接判断双工状态。触发器原型半双工告警模板在监控项原型下定义了一个触发器原型trigger prototype表达式为last(/Module EtherLike-MIB SNMPv3/net.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}])2属性值名称Interface {#IFNAME}({#IFALIAS}): In half-duplex mode优先级warning描述Please check autonegotiation settings and cabling触发器逻辑非常简单直接只要某个接口的dot3StatsDuplexStatus最新值等于 2halfDuplex就触发 warning 告警。由于监控项每 1 分钟更新一次半双工状态的检测延迟最多约 1 分钟。恢复表达式为空告警会在双工状态恢复到 fullDuplex值 3后依据 Zabbix 的默认问题恢复规则自动关闭监控项值不再等于 2触发器即不满足问题随之恢复。告警描述建议运维人员检查自协商设置与线缆Please check autonegotiation settings and cabling——半双工的常见根因包括对端端口被强制为某一固定速率/双工、网线质量差或水晶头接触不良、中间经过不支持的转发设备导致协商失败等。触发器名称带有{#IFNAME}({#IFALIAS})问题列表中可以直接定位到具体接口。另外注意5.0 的 XML 版本文档中出现了两条同名触发器记录其中一条带 (LLD) 后缀这是旧版 README 的展示差异实际模板源码中只定义了一个触发器原型。与其他模块模板的组合使用README 声明该模板是为 Template Net HP 和 Aruba Enterprise Switch SNMPv3 设计的因此在仓库中可以找到同一批由 SNMPv2 模块升级而来的 SNMPv3 姊妹模块均位于 Network_Devices/Generic 目录下共享相同的设计模式discoveryOID、V3后缀键值、同一组 SNMPv3 凭证宏template_module_generic_snmpv3提供系统级监控项sysDescr、sysName、sysUpTime、SNMP 可用性等与 SNMP trap fallbacktemplate_module_interfaces_snmpv3提供接口流量、速率、错误、丢包、链路状态等 IF-MIB 监控。典型用法是把这三个模块Generic Interfaces EtherLike-MIB一起链接到上层交换机模板或直接链接到主机即可同时获得系统可用性 接口流量 双工状态的完整监控视图三个模块统一使用{$SECURITY_NAME}、{$AUTH_PASSPHRASE}、{$PRIV_PASSPHRASE}三个宏凭证只需配置一次。仓库中 template_hp 等上层模板也引用了同类模块可以作为组合使用时的参考。若需要 SNMPv2 版本可参考仓库内同主题的 SNMPv2 模块模板如 Ubiquiti EdgeMAX 等模板中链接的Template Module EtherLike-MIB SNMP。快速上手清单根据 Zabbix 版本选择 5.0 XML、5.4 YAML 或 6.0 YAML在 Zabbix Web 界面Configuration → Templates → Import导入在目标交换机上启用 SNMPv3安全级别authPriv认证 SHA、加密 AES128并确认其支持 EtherLike-MIB在 Zabbix 主机上配置 SNMP 接口版本 SNMPv3或定义宏{$SECURITY_NAME}、{$AUTH_PASSPHRASE}、{$PRIV_PASSPHRASE}并在接口字段中引用将本模块模板链接到主机或上层设备模板可与Module Generic SNMPv3、Module Interfaces SNMPv3组合使用等待首次发现最长 1 小时进入Monitoring → Latest data查看net.if.duplex[...]监控项若发现某接口显示halfDuplex并产生 warning 告警按提示排查对端协商配置与物理线缆。需要留意的是发现规则更新间隔为 1h、监控项为 1m若刚导入模板接口可能需要等到下一个发现周期才会出现在监控项列表中这是 SNMP LLD 的正常行为。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix EtherLike-MIB SNMPv3 模块模板基于 LLD 的交换机接口双工状态监控实战指南Zabbix EtherLike MIB SNMPv3 模块模板基于 LLD 的交换机接口双工状态监控实战指南 导读 本文围绕 community templZabbix Community Templates基于 EtherLike-MIB 的 SNMPv3 模块化双工状态监控模板解析Zabbix Community Templates基于 EtherLike MIB 的 SNMPv3 模块化双工状态监控模板解析 本文以 Zabbix 社区pure_live 录制控制器启用有界 HLS 保留从预取能力验证到用户录制入口的完整接线pure_live 录制控制器启用有界 HLS 保留从预取能力验证到用户录制入口的完整接线 导读 本文以 pure_live 的审计记录 HLS_CONTRO上一篇解决Tauri应用中Shell.open权限问题的完整指南下一篇从命令行到音乐天堂Home Manager集成MPD/MPC打造终极音乐体验创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考