【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载导读本文围绕 Zabbix Community Templates 仓库中的 HP A5120 交换机 SNMP v3 监控模板展开完整讲解该模板的监控范围、SNMP v3 认证配置方式、全部监控项与低层发现LLD机制并结合仓库中的 YAML 导出文件剖析底层 OID 与触发器实现。读完本文你将掌握如何在 Zabbix 中导入并配置这套模板对 HPComware 系交换机实现 CPU、内存、温度、风扇、电源与接口 CRC 错误的开箱即用监控并了解模板在 Zabbix 5.4 → 7.0 演进中的关键变化。模板概览一个专注交换机健康状态的轻量模板该模板由作者 Jakub Samek 维护模板名为HP A5120归属于Template Switches模板组。根据 5.4 README 与 5.4 模板 YAML 的描述其监控能力覆盖CPU 使用率switch.cpu内存使用率switch.memory设备温度switch.temp风扇状态fan1.status电源PSU传感器状态内部/外部电源设备名称、位置、描述与联系人信息sysName / sysLocation / sysDescr / sysContact基于低层发现LLD的接口 CRC 错误监控README 明确了两点设计取舍无模板链接Template links该模板不链接任何其他模板不包含标准接口流量监控项如需监控接口带宽等通用信息README 建议搭配 Zabbix 自带的通用 SNMP 接口模板使用。这一设计让模板保持小而专聚焦交换机本体健康度避免与官方接口模板职责重复。部署前置SNMP v3 authPriv 认证与主机宏模板作者在 README 中说明其典型使用场景为SNMP v3安全级别authPriv认证协议 SHA加密协议 AES。因此模板本身不定义任何 SNMP 凭证宏而是要求在使用时通过**主机宏host macros**为每一台设备注入正确的取值宏名称用途{$SNMP_V3_USER}SNMP v3 安全名Security name{$SNMP_V3_AUTHPASSPHRASE}认证口令Authentication passphrase{$SNMP_V3_PRIVPASSPHRASE}加密口令Privacy passphrase配套的操作步骤在 Zabbix 前端完成导入模板进入Configuration → Templates → Import选择 5.4 版本的 YAML 文件仓库同时提供 5.0 XML 与 6.0 YAML 版本创建/编辑主机为主机配置 SNMP 接口选择 SNMP v3、安全级别authPriv、认证协议 SHA、隐私协议 AES设置主机宏在主机Macros页填入{$SNMP_V3_USER}、{$SNMP_V3_AUTHPASSPHRASE}、{$SNMP_V3_PRIVPASSPHRASE}三个宏的实际值链接模板将HP A5120模板链接到该主机。注意README 同时提到{$SNMP_COMMUNITY}为全局宏global macro仅在沿用社区字符串场景下需要关注使用 SNMP v3 时以 v3 三个宏为准。另外在 5.4 README 的 Macros used 一节明确写了 There are no macros links in this template即模板内部不预置宏定义所有凭证类取值完全依赖主机宏覆盖这也符合 Zabbix 的安全实践——避免把口令写死在模板里。监控项全解从 OID 到业务含义下表完整列出模板采集的全部监控项来源于 5.4 README 的 Items collected 及对应 YAML监控项名称键Key类型更新间隔说明Device locationsysLocationSNMP agent3600s节点物理位置Device namesysNameSNMP agent3600s节点管理名通常为 FQDNDevice contact detailssysContactSNMP agent3600s联系人信息Device descriptionsysDescrSNMP agent3600s设备软硬件描述CPU usageswitch.cpuSNMP agent60sCPU 使用率%Memory usageswitch.memorySNMP agent60s内存使用率%Switch Temperatureswitch.tempSNMP agent60s温度°C浮点Fan 1fan1.statusSNMP agent60s风扇状态Internal Power Supply 1Int.Power.Supply1SNMP agent60s内部电源状态External Power Supply 1Ext.Power.SupplySNMP agent60s外部电源状态Power Supply SensorPower.Supply.SensorSNMP agent60s电源传感器状态SysUptimeSysUptimeSNMP agent300s系统运行时长CRC errors on interface $1CRC.Errors[{#SNMPVALUE}]SNMP agent120s各接口 CRC 错误计数LLD 生成私有 MIB 读取点设备健康数据的真实来源从 5.4 YAML 可以看到CPU、内存、温度、风扇、电源等核心健康数据均来自1.3.6.1.4.1.25506私有企业 OID 分支监控项实际 OID更新间隔CPU usage1.3.6.1.4.1.25506.2.6.1.1.1.1.6.3060sMemory usage1.3.6.1.4.1.25506.2.6.1.1.1.1.8.3060sSwitch Temperature.1.3.6.1.4.1.25506.2.6.1.1.1.1.12.260sFan 1.1.3.6.1.4.1.25506.8.35.9.1.1.1.2.160sInternal Power Supply 1.1.3.6.1.4.1.25506.8.35.9.1.2.1.2.160sExternal Power Supply 11.3.6.1.4.1.25506.8.35.9.1.2.1.2.260s从 OID 前缀1.3.6.1.4.1.25506可以推断模板直接轮询的是设备内置的 Comware/H3C 系私有 MIBHP A5120 系列为基于 Comware 平台的交换机。这正是模板无需外部脚本、仅靠 SNMP agent 类型监控项即可工作的原因——所有读数都直接来自设备的 MIB 表项。模板还通过value_type、units与预处理对原始值做了归一化switch.temp声明为FLOAT类型、单位°C保证温度可精确到小数并正确渲染单位SysUptime采集1.3.6.1.2.1.1.3.0IF-MIB sysUpTime单位是百分之一秒并通过MULTIPLIER预处理步骤乘以0.01转换为秒sysContact/sysDescr/sysLocation/sysName均为字符型且分别通过inventory_link映射到 Zabbix 资产清单inventory的CONTACT、HARDWARE、LOCATION、NAME字段——即设备信息采集后会自动回填资产清单便于后续资产盘点。低层发现接口 CRC 错误监控模板唯一的发现规则名为Network interface errors见 5.4 README 的 Discovery rules属性取值名称Network interface errors类型SNMP agent键ifDescription发现方式discovery[{#SNMPVALUE},IF-MIB::ifDescr]更新间隔3600s发现规则以IF-MIB::ifDescr为索引枚举设备全部接口并为每个接口生成原型监控项item_prototypes: - name: CRC errors on interface $1 type: SNMP_AGENT snmp_oid: EtherLike-MIB::dot3StatsAlignmentErrors.{#SNMPINDEX} key: CRC.Errors[{#SNMPVALUE}] delay: 120也就是说每个被发现的接口都会生成一个键为CRC.Errors[{#SNMPVALUE}]的监控项每 120 秒读取一次EtherLike-MIB::dot3StatsAlignmentErrorsFCS 校验错误计数器。README 提示如果需要更精细的过滤可考虑改用IF-MIB::ifType或IF-MIB::ifAlias作为发现依据。触发器体系告警阈值与恢复逻辑CRC 错误增量告警average模板为 CRC 错误生成了原型触发器trigger prototype表达式为change(/HP A5120/CRC.Errors[{#SNMPVALUE}])1采用change()函数判断两次取值之间的增量即只有当某接口的 CRC 错误计数在轮询间隔内出现增长超过 1时才告警而不是对绝对计数告警——这样可以有效避免历史累计错误数一直很高但当前已无新错误的误报。该触发器没有单独的恢复表达式属于 average平均优先级。CPU / 内存 / 温度 / 重启触发器来自 YAML 源码5.4 README 的触发器表格只列了 CRC 相关条目而完整触发器集合记录在 5.4 YAML 的triggers段中汇总如下触发器名称表达式优先级CPU usage on {HOST.HOST} 80%last(/HP A5120/switch.cpu)80highMemory usage on {HOST.HOST} 80%last(/HP A5120/switch.cpu)80注意5.4 中误用 CPU 键highTemperature on {HOST.HOST} is 45({TRIGGER.VALUE}0 and last(/HP A5120/switch.temp)45) or ({TRIGGER.VALUE}1 and last(/HP A5120/switch.temp)40)high{HOSTNAME} Has been restartedlast(/HP A5120/SysUptime)1000info其中温度触发器采用滞回hysteresis写法触发条件为温度 45°C而恢复条件为温度降到 40°C 以下即问题状态期间阈值放宽到 40°C避免温度在阈值附近抖动造成告警震荡。5.4 版本的一个已知缺陷源码证据细读 5.4 YAML 会发现一个值得注意的实现问题Memory usage 触发器实际引用的是switch.cpu键而非switch.memory。这一缺陷在模板 7.0 重构时被作者明确修复7.0 README 的 Changes for Zabbix 7.0 一节写有Fixed memory trigger (it was checking CPU item instead of memory).因此在使用 5.4 或 6.0 版本模板时需要留意内存告警实际反映的是 CPU 使用率升级到 7.0 版本后该问题已消除。版本演进从 5.4 到 7.0 的架构升级同一模板在仓库中同时维护了 5.0、5.4、6.0 与 7.0 四个版本。README 注明模板最初创建于 Zabbix 3.07.0 版已实测于HP A5120-48G EI设备与Zabbix 7.0.29环境。对照 7.0 README 与 7.0 YAML7.0 版本的主要变化可归纳为四类1. 接口监控体系重构单次 bulk walk 依赖监控项7.0 版不再使用旧式discovery[]发现而是引入一个主监控项master itemnet.if.walksnmp_oid: walk[1.3.6.1.2.1.2.2.1.2,1.3.6.1.2.1.2.2.1.3,1.3.6.1.2.1.2.2.1.7,1.3.6.1.2.1.2.2.1.8,1.3.6.1.2.1.31.1.1.1.1,1.3.6.1.2.1.31.1.1.1.6,1.3.6.1.2.1.31.1.1.1.10,1.3.6.1.2.1.31.1.1.1.15,1.3.6.1.2.1.31.1.1.1.18] key: net.if.walk history: 0一次 SNMP bulk walk 同时拉取ifDescr、ifType、ifAdminStatus、ifOperStatus、ifName、ifHCInOctets、ifHCOutOctets、ifHighSpeed、ifAlias九个 OID 列历史存储关闭history: 0。随后发现规则net.if.discovery成为依赖监控项typeDEPENDENT通过SNMP_WALK_TO_JSON预处理把 walk 结果解析成{#IFDESCR}、{#IFNAME}、{#IFALIAS}、{#IFTYPE}等发现宏每个接口的 Admin status、Operational status、Bits received、Bits sent、Speed 都是依赖监控项通过SNMP_WALK_VALUE从主监控项取值并用CHANGE_PER_SECONDMULTIPLIER 8把字节计数器换算成 bps 速率。这种单次 walk 依赖项架构的收益是管理状态与运行状态来自同一次轮询天然保证一致性同时大幅减少对设备的 SNMP 请求次数。2. 新增链路与带宽告警7.0 版补齐了 5.4 版刻意缺失的接口监控新增两个原型触发器Link downaverage{$IFCONTROL:{#IFNAME}}1 and last(adminstatus)1 and last(operstatus)2 and last(operstatus,#2)1即只有管理状态 up、前一周期运行状态 up、当前运行状态 down才告警设备发现时已处于 down、或管理员shutdown的接口均被忽略恢复表达式同时考虑接口恢复与管理性关闭两种情形High bandwidth usagewarningavg(net.if.in,15m) ({$IF.UTIL.MAX}/100) * last(speed)入向或出向任一超过阈值即告警并以 15 分钟均值衡量、以ifHighSpeed为基准速度报告为 0 的接口自动忽略。配套宏定义见 7.0 YAML 的macros段宏默认值说明{$IF.UTIL.MAX}90带宽利用率阈值%可用带上下文宏按接口覆盖如{$IF.UTIL.MAX:Ten-GigabitEthernet1/1/1}80{$IFCONTROL}1链路 down 告警开关0关闭可按接口覆盖如{$IFCONTROL:GigabitEthernet1/0/24}0{$NET.IF.IFTYPE.MATCHES}^(6|136|161)$参与发现的 ifType 正则6以太网口、136Vlan 接口、161链路聚合口{$NET.IF.NO_TRAFFIC.IFTYPE.MATCHES}^136$只监控状态不监控流量的 ifType默认 Vlan 接口通过 LLD override 禁用其流量/CRC 项与图形3. 设备健康监控的修正与增强修复内存触发器误用switch.cpu的问题CRC 监控项由dot3StatsAlignmentErrors改为EtherLike-MIB::dot3StatsFCSErrorsFCS 错误语义更贴近 CRC 校验失败温度触发器弃用{TRIGGER.VALUE}滞回写法改为独立的恢复表达式last(...)40为风扇/电源状态引入值映射HH3C-LSW-DEV-ADM-MIB::DevStatus1active、2deactive、3not-install、4unsupport并新增电源/风扇 installed 但 deactive的高优先级告警not-install未安装不告警移除与Int.Power.Supply1读取同一 OID 的冗余项Power Supply Sensor标签体系由Application标签改为component标签告警补充scope标签availability / performance / capacity 等更贴合 Zabbix 6.0 的标签实践。使用注意事项与限制综合 5.4 README 及源码实际落地时有几点需要留意接口流量监控需自行补充5.4/6.0 版本模板只负责交换机健康项与 CRC 错误带宽类监控需另配通用 SNMP 接口模板若使用 7.0 版本则接口带宽、链路状态、聚合口/Vlan 接口状态已内置凭证务必走主机宏模板不含默认凭证未正确配置{$SNMP_V3_USER}/{$SNMP_V3_AUTHPASSPHRASE}/{$SNMP_V3_PRIVPASSPHRASE}三个宏会导致全部监控项无数据5.4/6.0 的内存告警缺陷如前所述Memory usage 80% 触发器在 5.4/6.0 中实际判断的是 CPU 项升级到 7.0 模板可修复设备型号适用性模板以 HP A5120 系列Comware 平台为目标7.0 版已在 HP A5120-48G EI 上实测用于其他型号时建议先用snmpwalk核对上述 25506 私有 OID 是否存在发现频率CRC 发现规则更新间隔为 3600s新接口最迟一小时内被纳入监控CRC 计数轮询间隔为 120s告警存在一个轮询周期的延迟。小结HP A5120 交换机 SNMP v3 模板是一套结构清晰、边界明确的社区模板以私有 MIB 直读的方式覆盖交换机 CPU、内存、温度、风扇、电源与接口 CRC 错误凭证通过主机宏注入以保证安全。对于追求轻量、可控、无脚本依赖的 Comware 系交换机监控场景5.4 版本即可满足核心需求而在 Zabbix 7.0 环境中推荐直接使用经过重构的 7.0 版本——它在接口流量、链路告警、值映射与触发器恢复逻辑上提供了更完整的开箱能力也让 CPU/内存告警回归正确语义。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix 监控 HP A5120 交换机实战community-templates 的 SNMP v3 模板深度解析与部署指南Zabbix 监控 HP A5120 交换机实战community templates 的 SNMP v3 模板深度解析与部署指南 本文基于 Zabbix CZabbix 社区模板实战基于 SNMP 监控 HP Procurve 2920 系列交换机Zabbix 社区模板实战基于 SNMP 监控 HP Procurve 2920 系列交换机 导读 本文基于 Zabbix Community TemplatZabbix 社区模板实战HP v1920-24G 交换机 SNMP 全端口监控模板深度解析与部署指南Zabbix 社区模板实战HP v1920 24G 交换机 SNMP 全端口监控模板深度解析与部署指南 本文围绕 Zabbix Community Templ上一篇4步彻底卸载ExplorerPatcher从标准移除到注册表残留清理的完整路径下一篇超简单Prism开发环境搭建5分钟上手语法高亮创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考