
【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本篇以 Zabbix 社区模板仓库 community-templates 中的SNMP HP v1905 POE模板为主体完整讲解该模板如何通过 SNMP agent 对一台 HP 1905 系列 PoE 交换机的 26 个端口采集运行状态、收发字节、收发错误计数并配套 CRC 错误、端口 down 和重启告警。读完本文你可以掌握该模板全部 132 个监控项与 79 个触发器的组织方式、每个端口项对应的真实 OID 偏移规律、默认禁用项的处理方法以及将其导入 Zabbix 6.0 后的适用边界与迁移注意事项。模板定位与仓库文件结构该模板位于仓库的Network_Devices/HP/目录下按 Zabbix 版本提供了三种历史导出格式版本目录文件说明6.0template_zabbix_2.2_hp_v1905_poe_snmp.yamlYAML 导出zabbix_export.version: 6.0本文分析依据5.4template_zabbix_2.2_hp_v1905_poe_snmp.yaml面向 Zabbix 5.4 的 YAML 导出5.0template_zabbix_2.2_hp_v1905_poe_snmp.xml面向 Zabbix 5.0 的 XML 导出6.0README.md6.0 版本的监控项清单文档模板导出文件的元信息为模板名SNMP HP v1905 POE所属模板组Templates模板 uuid949cdd54be9544ff8f63d35be45b568b见 YAML 第 4–16 行。按 README.md 的说明该模板具有以下结构特征无用户宏There are no macros links in this template不需要在任何主机上预先配置宏无模板链接不依赖SNMP Interface等官方模板是独立模板导入后自成一体无发现规则LLD26 个端口是写死在模板中的固定条目而非通过低级别发现动态生成。这一点直接决定了它适用于端口固定、规划明确的接入交换机场景详见适用边界一节全部监控项类型均为SNMP agent。监控项体系132 个项的分类与参数README 的 Items collected 表格共列出 132 个监控项每行一项见 README 第 17–150 行对照 6.0 YAML 导出可将其归纳为 7 类分类命名规律Key 规律SNMP OID采集间隔数量设备描述Model.1.3.6.1.2.1.1.1.0sysDescr3600 s1运行时长UptimeUptime.1.3.6.1.2.1.1.3.0sysUpTime60 s1端口状态Status port 1…Status port 26ifOperStatus.N1.3.6.1.2.1.2.2.1.8.N120 s26接收字节Bytes Rx port 1…port 26ifInOctets.NifInOctets.(518128×(N-1))120 s26发送字节Bytes Tx port 1…port 26ifOutOctets.NifOutOctets.(518128×(N-1))120 s26接收错误Errors Rx port 1…port 26ifInErrors.NifInErrors.(518128×(N-1))120 s26发送错误Errors Tx port 1…port 26ifOutErrors.NifOutErrors.(518128×(N-1))120 s26所有端口项均设置 7 天历史history: 7d。每个端口项还带有Application标签取值为Oper Status/Bytes Rx/Bytes Tx/CRC Errors Rx/CRC Errors TxModel与Uptime的标签值为General——这使得在 Zabbix 前端按标签筛选、聚合时可以把 26 个端口归入同一应用维度。几个关键项值得单独展开。Model写入设备清单的描述项Model项读取sysDescrOID.1.3.6.1.2.1.1.1.0值类型 TEXT采集间隔 1 小时且配置了inventory_link: MODEL即采集值会自动回填到主机清单的型号字段同时显式关闭了趋势trends: 0见 YAML 第 17–31 行。Uptime带单位换算的秒级 uptime 与重启告警Uptime项读取sysUpTimeOID.1.3.6.1.2.1.1.3.0采集间隔 60 秒单位为s。注意它带了一个预处理步骤见 YAML 第 2632–2654 行units: s preprocessing: - type: MULTIPLIER parameters: - 0.01sysUpTime原始单位是 hundredths of a second1/100 秒该模板通过MULTIPLIER 0.01预处理将其换算为秒因此图上读到的就是直观的秒数。它挂载了一个 AVERAGE 级别触发器expression: last(/SNMP HP v1905 POE/Uptime)600 name: {HOSTNAME} has just been restarted即设备运行时间不足 600 秒10 分钟时产生刚刚重启过的告警——这是识别交换机闪断、重启问题的标准做法。端口项的 OID 偏移从导出文件看实测 ifIndex 的写死策略这是本模板最值得注意的实现细节。在 6.0 导出文件 中README 表格里展示的 Key如ifInOctets.1与真实的snmp_oid并不相同。以Errors Rx port 1为例YAML 第 32–43 行name: Errors Rx port 1 type: SNMP_AGENT snmp_oid: ifInErrors.518 key: ifInErrors.1 delay: 120Key 中的端口号1是给人看的逻辑端口号而snmp_oid指向的是 ifTable 中该端口的真实实例索引 518。对全部 26 个端口项逐行核对后可以确认其 OID 实例号呈严格的等差数列端口 N 的实例索引 518 128 × (N - 1) 端口 1 → ifInErrors.518 端口 2 → ifInErrors.646 端口 3 → ifInErrors.774 ... 端口 26 → ifInErrors.3718从导出文件结构看作者是在该型号 HP 1905 交换机上实测 ifIndex 后把每个端口的 OID 直接写死为具体实例。这种写死式做法的优点是导入即用、无需 LLD局限则在于端口号与物理端口的对应关系取决于该设备的 ifIndex 布局迁移到其他设备或固件后必须重新核对可通过snmpget/snmpwalk查询1.3.6.1.2.1.2.2.1.1.0ifDescr逐实例确认状态项ifOperStatus.N使用的却是标准 ifTable 索引1.3.6.1.2.1.2.2.1.8.NN1…26见 YAML 第 1073–1084 行与流量/错误项的 518 偏移方案并不一致。这说明状态项的索引映射以设备实际 ifTable 为准二者取值逻辑不同排查端口数据异常时应分别核对。默认禁用26 个状态项与 26 个端口 down 触发器Status port N项及其触发器在导出文件中均标记status: DISABLED全文件共 52 处status: DISABLED恰好对应 26 个状态项 26 个触发器。以Status port 1为例YAML 第 1073–1091 行name: Status port 1 type: SNMP_AGENT snmp_oid: 1.3.6.1.2.1.2.2.1.8.1 key: ifOperStatus.1 delay: 120 status: DISABLED triggers: - expression: last(/SNMP HP v1905 POE/ifOperStatus.1)2 name: Port 1 status down on {HOSTNAME} status: DISABLED priority: INFO触发条件last(...)2对应ifOperStatus的down状态值。作者默认禁用了这些项推测是为了让模板导入后先只跑流量与错误类采集使用者在确认状态项 OID 映射无误后再按需启用——实际使用时需要在 Zabbix 前端逐项或按端口启用。触发器体系79 个触发器的完整构成这里需要指出 README 与导出文件之间的一个差异README 的 Triggers 章节写着 There are no triggers in this template但从 6.0 导出文件的结构看触发器以嵌套在监控项内的形式存在Zabbix 5.4 导出格式的常见组织方式README 的汇总章节并未把它们统计进去。完整清点后模板实际包含 79 个触发器分三组触发器组表达式级别默认状态数量CRC 接收错误last(/SNMP HP v1905 POE/ifInErrors.N)100HIGH启用26CRC 发送错误last(/SNMP HP v1905 POE/ifOutErrors.N)100HIGH启用26端口 downlast(/SNMP HP v1905 POE/ifOperStatus.N)2INFO禁用26设备重启last(/SNMP HP v1905 POE/Uptime)600AVERAGE启用1CRC 错误触发器挂载在每个错误计数项之下命名形如CRC Errors Rx on port 1见 YAML 第 44–49 行阈值统一为最近一次采集值大于 100。由于ifInErrors/ifOutErrors本身是单调递增计数器这里用last() 100判断累计错误数而非错误速率意味着阈值 100 是一次性累计门槛设备重启计数器清零后会重新累积。若希望监控瞬时错误突增可以自行将表达式改造为基于diff()/change()的速率型判断——但注意仓库只读此类调整应在导入后于 Zabbix 前端修改而不是改动本仓库文件。端口 down 触发器使用{HOSTNAME}宏在消息中带上主机名且默认禁用原因见上一节。图表26 张逐端口流量图模板附带 26 张名为Port 1 stats…Port 26 stats的图表见 YAML 第 2655–2687 行每张图固定包含两条曲线name: Port 1 stats graph_items: - color: 000099 item: host: SNMP HP v1905 POE key: ifOutOctets.1 - sortorder: 1 color: 990000 item: host: SNMP HP v1905 POE key: ifInOctets.1发送字节ifOutOctets.N深蓝色000099与接收字节ifInOctets.N深红色990000同图展示ymin_type_1: FIXED固定 Y 轴起点为 0。由于字节项是计数器Zabbix 前端会按增量展示流量。导入与使用在 Zabbix 6.0 Web 界面进入管理 → 模板 → 导入模板选择本仓库 6.0 目录下的 YAML 文件 导入5.4 / 5.0 版本用户请选用对应目录的文件模板无宏、无模板链接导入后无需额外前置配置。创建被监控主机时将模板应用到该 HP 交换机并配置好 SNMP 接口SNMPv2 社区串或对应的 SNMPv3 凭据导入后默认生效的采集包括Model1 小时一次、Uptime60 秒一次、26 端口 ×收发字节 收发错误共 104 个 120 秒间隔的项以及 52 个 CRC 错误 HIGH 触发器和重启 AVERAGE 触发器如需端口 down 告警在模板或主机层启用 26 个Status port N项及其触发器。适用边界与迁移注意版本适配模板按 Zabbix 版本分目录存放请以所在版本对应的导出文件导入6.0 文件声明的zabbix_export.version为6.0YAML 第 1–3 行。无 LLD 的固定端口设计26 个端口全部是静态项适合端口数量、编号固定的接入层交换机。若网络中存在大量型号混杂的交换机或端口会动态变化带 LLD 的接口发现方案如仓库中其他 Generic/HP 接口类模板会更合适。ifIndex 写死如前所述流量与错误项的 OID 是按该设备实测 ifIndex518 起、步长 128写死的更换设备时务必先用snmpwalk核对ifDescr与ifInErrors等表项的实例号再决定是修改 OID 还是换用带发现的模板。计数器型阈值CRC 告警基于累计值100设备重启会清零重新累积解读告警时需结合Uptime与重启告警一起看。小结SNMP HP v1905 POE模板用 132 个 SNMP agent 项、79 个触发器和 26 张端口流量图为 HP 1905 系列 PoE 交换机提供了一套零宏依赖、导入即用的逐端口监控方案sysDescr/sysUpTime覆盖设备基础信息ifInOctets/ifOutOctets/ifInErrors/ifOutErrors覆盖 26 个端口的流量与 CRC 错误ifOperStatus提供可按需启用的端口 down 告警。理解其中逻辑端口 Key 实测 ifIndex OID的映射方式和 518 偏移规律是正确复用与迁移该模板的关键。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix 社区模板 SNMP HP v1905 POE用 SNMP 监控 HP ProCurve v1905 PoE 交换机 26 个端口的完整实战Zabbix 社区模板 SNMP HP v1905 POE用 SNMP 监控 HP ProCurve v1905 PoE 交换机 26 个端口的完整实战 本文Zabbix 社区模板实战用 SNMP 模板 SNMP HP v1905 POE 监控 HP 1905 网管型 PoE 交换机的 26 个端口Zabbix 社区模板实战用 SNMP 模板 SNMP HP v1905 POE 监控 HP 1905 网管型 PoE 交换机的 26 个端口 本文围绕 Za用 Zabbix 监控 HP OfficeConnect 19XX 交换机community-templates 中 SNMP OfficeConnect 19XX 模板完全解析用 Zabbix 监控 HP OfficeConnect 19XX 交换机community templates 中 SNMP OfficeConnect 1上一篇如何快速上手TinyFish Cookbook3步跑通你的第一个网页Agent免费API KeycURL实战下一篇写漏了会被指出来Drama Skills检查脚本如何跨文档对账并精准报错创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考