【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载导读本文围绕 community-templates 仓库中 Cisco SG500X_48P 模板系统讲解如何借助该 Zabbix 模板对 Cisco SG500 / SG500X 系列交换机进行 SNMP 监控。模板覆盖风扇Cooler/FAN、设备可用性与延迟、端口出入流量与错误包、CPU、温度、端口速率/MTU/运行状态等 8 大类指标本文将从导入部署、监控项清单、OID 与预处理原理到扩展建议逐一展开读完即可上手部署并理解每个监控项的底层取值逻辑。一、模板概览它到底监控什么模板名称为SG500X_48P由社区作者 Magno Monte Cerqueira昵称 magnopeem编写并分享原始 README 中明确列出了模板所监控的 8 项内容Cooler风扇 / FANDisponibilidade可用性Latencia延迟Pacotes de entrada入方向数据包Pacotes de Saida出方向数据包Temperatura温度Trafego de entrada入方向流量Trafego de saida出方向流量仓库在 Network_Devices/Cisco/template_cisco_sg500_48p 目录下同时维护了三个 Zabbix 版本Zabbix 版本模板文件说明5.0template_cisco_sg500_48p.xmlXML 格式导出5.4template_cisco_sg500_48p.yamlYAML 格式导出导出时间 2021-11-216.0template_cisco_sg500_48p.yamlYAML 格式导出三个版本的监控项完全一致仅格式与zabbix_export.version不同可按你的 Zabbix 主版本选择对应文件。二、快速上手导入模板并关联主机1. 导入模板在 Zabbix Web 前端中进入配置Configuration→ 模板Templates→ 导入Import选择对应版本的模板文件即可Zabbix 5.4 / 6.0导入 5.4 或 6.0 的 YAML 文件Zabbix 5.0导入 5.0 的 XML 文件。导入成功后模板列表会出现SG500X_48P。从 YAML 导出结构看template_cisco_sg500_48p.yaml模板归属于默认的Templates组。2. 关联主机与 SNMP 接口配置模板中的全部采集项都以SNMP agent或Simple checkICMP方式工作因此主机侧需要在主机Host配置中为该交换机添加SNMP 接口IP 地址、端口默认 161、SNMP 版本需与设备一致通常为 v2c关联模板SG500X_48P确认 SNMP Community。由于模板没有定义任何宏README 与 YAML 中Macros used均为空SNMP 读取凭据将使用 Zabbix 全局宏{$SNMP_COMMUNITY}默认值public。若设备使用了非默认 community请在主机或模板层级覆盖该宏。3. 关于接口索引ifIndex的核对模板中的端口监控项针对两个固定接口写死GigabitEthernet 1/1/1ifIndex 49与TenGigabitEthernet 1/1/1ifIndex 107对应 SG500X-48P 的千兆接入端口与万兆上联端口。不同批次或配置的设备其 ifIndex 可能不一致建议导入后用 snmpwalk 核对snmpwalk -v2c -c public switch-ip IF-MIB::ifName确认ifIndex 49与107确实对应GigabitEthernet 1/1/1和TenGigabitEthernet 1/1/1如果不一致需要在导入后修改相应监控项的 OID/Key 后缀。三、监控项全景24 个采集项完整清单模板共采集24 个监控项下表完整列出每个监控项的名称保留原始葡萄牙语命名附中文释义、类型、Key 与更新间隔与 README 的 Items collected 表完全对应监控项名称原文 / 中文类型Key更新间隔Ping可用性Simple checkicmpping30sPing por Segundo延迟Simple checkicmppingsec30sTempo Ligado运行时间SNMP agentsystem.uptime60sCPUCPU 使用率SNMP agent.1.3.6.1.4.1.9.9.109.1.1.1.1.5120sTemperatura温度SNMP agententPhySensorValue.68420481120sFan 01风扇 1SNMP agentrlEnvMonFanState.67109250600sFan 02风扇 2SNMP agentrlEnvMonFanState.67109251600sFan 03风扇 3SNMP agentrlEnvMonFanState.67109252600sFan 04风扇 4SNMP agentrlEnvMonFanState.67109253600sFan 05风扇 5SNMP agentrlEnvMonFanState.67109254600sFan 06风扇 6SNMP agentrlEnvMonFanState.67109255600sEstado operacional GigabitEthernet 1/1/1端口操作状态SNMP agentifOperStatus.4960sVelocidade da Porta GigabitEthernet 1/1/1端口速率SNMP agentifSpeed.4960sVelocidade Porta GigabitEthernet 1/1/1 MTU端口 MTUSNMP agentifMtu.4960sTráfego de entrada GigabitEthernet 1/1/1入方向流量SNMP agentifInOctets.4960sTráfego de saída GigabitEthernet 1/1/1出方向流量SNMP agentifOutOctets.4960sPacotes de entrada com erro GigabitEthernet 1/1/1入方向错误包SNMP agentifInErrors.4960sPacotes de saída com erro GigabitEthernet 1/1/1出方向错误包SNMP agentifOutErrors.4960sVelocidade da Porta Tengigabitethernet 1/1/1端口速率SNMP agentifSpeed.10760sVelocidade Porta Tengigabitethernet 1/1/1 MTU端口 MTUSNMP agentifMtu.10760sTráfego de entrada Tengigabitethernet 1/1/1入方向流量SNMP agentifInOctets.10760sTráfego de saída Tengigabitethernet 1/1/1出方向流量SNMP agentifOutOctets.10760sPacotes de entrada com erro Tengigabitethernet 1/1/1入方向错误包SNMP agentifInErrors.10760sPacotes de saída com erro Tengigabitethernet 1/1/1出方向错误包SNMP agentifOutErrors.10760s采集频率设计上做了明显分层ICMP 探测 30s、接口类指标 60s、CPU 与温度 120s、风扇状态 600s风扇变化缓慢低频轮询即可降低 SNMP 负载。历史保留期方面绝大多数监控项为 7d两个 MTU 监控项为 2d见 YAML 配置。四、关键监控项与 OID 深度解读结合模板 YAML 中实际的snmp_oid与预处理配置可以还原每个监控项底层的 MIB 来源与取值逻辑。1. 风扇状态CISCO-ENVMON-MIBrlEnvMonFanState6 个风扇监控项均来自 Cisco 环境监控 MIBCISCO-ENVMON-MIB基础 OID 为.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3Fan 01 的完整 OID 为.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109249YAML 第 285-291 行其余风扇 OID 后缀依次递增6710925067109254。风扇状态以枚举整数返回需要结合该 MIB 的状态定义解读如正常/故障/未知等。一个值得注意的源码细节YAML 中监控项 Key如rlEnvMonFanState.67109250与snmp_oid后缀如...67109249相差 1Key 仅是 Zabbix 内部存储标识实际轮询仍以snmp_oid为准不影响取值。2. 温度ENTITY-SENSOR-MIBentPhySensorValue温度监控项 OID 为.1.3.6.1.4.1.9.6.1.101.83.2.1.1.1.4.68420481对应实体传感器表entPhySensorValueENTITY-SENSOR-MIB返回交换机主板/环境温度单位为摄氏度units: C更新间隔 120s历史保留 7d。3. CPUCISCO-PROCESS-MIBcpmCPUTotal5minRevCPU 监控项直接使用数字 OID.1.3.6.1.4.1.9.9.109.1.1.1.1.5该 OID 对应CISCO-PROCESS-MIB的cpmCPUTotal5minRev即 CPU 近 5 分钟平均利用率0100 的百分比。模板作者在 YAML 中将此监控项的单位配置为CYAML 第 47-53 行如果你的设备该 OID 实际返回利用率百分比导入后建议在监控项属性中把单位改为%以免图形与告警单位语义不符。4. 端口计数器IF-MIBifInOctets / ifOutOctets / ifInErrors / ifOutErrors / ifSpeed / ifMtu / ifOperStatus两个被监控端口ifIndex 49 与 107的计数器全部来自标准IF-MIB包括ifInOctets.index/ifOutOctets.index入/出方向字节计数ifInErrors.index/ifOutErrors.index入/出方向错误包计数ifSpeed.index端口协商速率bpsifMtu.index端口 MTU字节ifOperStatus.index端口操作状态1up2down…。其中ifOperStatus.49关联了模板内置的值映射valuemapSNMP interface status (ifOperStatus)YAML 第 344-369 行将 17 的枚举值映射为up / down / testing / unknown / dormant / notPresent / lowerLayerDown图形中直接显示可读状态。5. 可用性与延迟ICMP 简单检查icmpping30s返回 1/0 表示目标可达与否用于可用性监控icmppingsec30s返回 ICMP 往返延迟秒数用于延迟监控。两者均定义为FLOAT类型。注意 ICMP 探测依赖 Zabbix Server/Proxy 到交换机的网络连通性与 SNMP 无关。6. 运行时间DISMAN-EVENT-MIBsysUpTimeTempo Ligado使用DISMAN-EVENT-MIB::sysUpTimeInstanceKey 为system.uptime单位秒。由于sysUpTime的原始单位为百分之一秒hundredths of seconds模板通过预处理MULTIPLIER × 0.01YAML 第 339-343 行换算为秒保证图形纵轴语义正确。五、预处理逻辑计数器如何变成速率模板中最核心的工程细节是对 SNMP 累计计数器counter施加的预处理链这一设计直接决定了图形展示的是“速率”而非“累计值”流量类CHANGE_PER_SECOND MULTIPLIER × 8以ifInOctets.49为例YAML 第 111-128 行预处理链为CHANGE_PER_SECOND将两次轮询间的字节增量换算为每秒字节数bytes/sMULTIPLIER × 8将 bytes/s 换算为 bits/s。最终监控项单位为b即 bps图形直接呈现端口实时带宽无需额外计算。入/出两个方向、千兆/万兆两个端口共 4 个流量监控项均采用同一套预处理链。错误包类CHANGE_PER_SECOND4 个错误包监控项ifInErrors.49/107、ifOutErrors.49/107只做CHANGE_PER_SECOND将累计错误计数转换为每秒错误包数单位为packets。速率与 MTU 类MULTIPLIERifSpeed.49/107MULTIPLIER × 1单位bps保留端口协商速率原值ifMtu.49/107MULTIPLIER × 1000000单位bYAML 第 149-176 行。需要说明的是ifMtu原始返回值为字节如 1500乘以 1,000,000 后数值本身不具备物理含义这是模板作者的原始配置若你更关心 MTU 的真实字节值可在导入后删除该预处理并调整单位。六、图形与值映射11 张图覆盖全部核心指标模板在 YAML 中预定义了11 张图形与 README 声明的 8 大监控主题一一对应图形名称包含监控项说明Cooler ( FAN )Fan 01066 条粗线BOLD_LINE不同颜色区分各风扇CPUCPU渐变线GRADIENT_LINEDisponibilidadeicmpping可用性趋势Latenciaicmppingsec延迟趋势Pacotes de entrada com erroifInErrors.49 / .107入方向错误包双端口同图对比Pacotes de saída com erroifOutErrors.49 / .107出方向错误包Tráfego de entradaifInOctets.49 / .107入方向带宽Tráfego de saídaifOutOctets.49 / .107出方向带宽Velocidade da PortaifSpeed.49 / .107端口协商速率Velocidade Porta MtuifMtu.49 / .107端口 MTUTempo Ligadosystem.uptime运行时间多端口图形统一采用双色区分如1A7C11与F63100便于在一张图上横向对比千兆接入端口与万兆上联端口的流量/错误情况。七、已知限制与扩展建议阅读模板导出结构与 README 中的Macros used / Template links / Discovery rules / Triggers四个小节可以得到明确的边界信息无触发器Triggers模板未定义任何告警规则。风扇停转、温度过高、端口 down、CPU 过高等场景不会自动产生告警需要使用者自行补充触发器例如对rlEnvMonFanState.*非正常值、ifOperStatus.49等于 2、温度超过阈值等设置告警无宏Macros未定义任何模板级宏SNMP 凭据依赖全局默认宏{$SNMP_COMMUNITY}无自动发现Discovery rules端口与风扇均为固定索引写死未使用 LLD 自动发现。若需要监控全部 48 个千兆端口建议以本模板为蓝本改用ifDescr/ifName的 LLD 规则批量生成监控项并将风扇状态纳入环境监控表的 LLD固定 ifIndex49与107依赖具体设备的接口编号导入前务必用 snmpwalk 核对见上文第三节。八、仓库文件速查用途路径5.4 版说明文档Network_Devices/Cisco/template_cisco_sg500_48p/5.4/README.md5.4 版模板YAMLNetwork_Devices/Cisco/template_cisco_sg500_48p/5.4/template_cisco_sg500_48p.yaml5.0 版模板XMLNetwork_Devices/Cisco/template_cisco_sg500_48p/5.0/template_cisco_sg500_48p.xml6.0 版模板YAMLNetwork_Devices/Cisco/template_cisco_sg500_48p/6.0/template_cisco_sg500_48p.yaml结合模板的 24 个监控项、11 张图形与 README 的 8 大监控主题该模板可以作为 Cisco SG500/SG500X 系列交换机“开箱即用”的硬件健康与关键端口流量监控基础在此基础上补充触发器和 LLD 扩展即可构建完整的生产级交换机监控方案。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix 监控 Cisco SG500-48P 交换机SG500X_48P 模板完整解析SNMP 风扇、温度、流量与端口监控Zabbix 监控 Cisco SG500 48P 交换机SG500X_48P 模板完整解析SNMP 风扇、温度、流量与端口监控 本指南以社区共享模板 SLiveCharts2 HeatLandSeries 完全指南用 GeoMap 控制件打造区域热力图LiveCharts2 HeatLandSeries 完全指南用 GeoMap 控制件打造区域热力图 HeatLandSeries 是 LiveCharts2Zabbix 社区模板实战基于 SNMP 监控 HP Procurve 2920 系列交换机Zabbix 社区模板实战基于 SNMP 监控 HP Procurve 2920 系列交换机 导读 本文基于 Zabbix Community Templat上一篇terminal-bench交互式教程通过示例学习评测平台下一篇揭秘ReflectionCommonphpDocumentor背后的通用反射类库深度剖析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考