★ FEATURED ARTICLE 【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本指南以社区共享模板 SG500X_48P 为主体系统讲解如何使用 Zabbix 通过 SNMP 与 ICMP 对 Cisco SG500 系列交换机以 SG500-48P 为例实施监控覆盖风扇Cooler/FAN、设备可用性、网络延迟、端口流量与错误包、温度、CPU 及运行时长等 8 类核心指标。读完本文后你将掌握该模板的 23 个监控项与 11 张图表的完整配置逻辑、预处理与值映射原理并学会在导入前核对 OID、在导入后按需扩展触发器与自动发现规则。模板概览与适用场景SG500X_48P 是发布在 Zabbix 社区共享平台上的交换机监控模板作者为 Magno Monte Cerqueira账号 magnopeem。从仓库中的模板定义文件可以看到模板默认面向Cisco SG500 系列交换机其监控范围覆盖CoolerFAN——6 个风扇状态Disponibilidade可用性——ICMP 可达性Latencia延迟——ICMP 往返时间Pacotes de entrada入向包——含错误包统计Pacotes de Saída出向包——含错误包统计Temperatura温度——机箱实体温度传感器Tráfego de entrada入向流量Tráfego de saída出向流量SG500-48P 是 Cisco Small Business 500 系列中的 48 口千兆 PoE 交换机同时提供 4 个万兆 SFP 上行端口。模板中硬编码的两个端口对象恰好对应这一硬件形态GigabitEthernet 1/1/1ifIndex 49第一个千兆口与Tengigabitethernet 1/1/1ifIndex 107第一个万兆口。这一点可以从模板中ifInOctets.49、ifInOctets.107等项目键名直接确认。模板同时使用两种数据采集方式SNMP agent端口、风扇、温度、CPU、uptime与Simple checkICMP ping。监控项全部为静态定义不依赖任何宏、模板链接template links或发现规则discovery rules导入后只需配置主机级 SNMP 与 ICMP 即可工作。模板文件结构与多版本支持该模板在仓库中按 Zabbix 大版本分目录维护位于Network_Devices/Cisco/template_cisco_sg500_48p/5.0 版本XML 格式适用于 Zabbix 5.0 系列采用zabbix_exportversion5.0/version的 XML 导出结构。5.4 版本YAML 格式适用于 Zabbix 5.4 系列。6.0 版本YAML 格式适用于 Zabbix 6.0 系列本文分析以此版本为准。各版本导出的监控项、图表与值映射内容保持一致区别仅在于导出格式和zabbix_export.version字段。以 6.0 版 YAML 为例其顶层结构为zabbix_export: version: 6.0 date: 2021-11-21T21:18:13Z groups: - uuid: 7df96b18c230490a9a0a9e2307226338 name: Templates templates: - uuid: 7566af4955664c428488e4c5dd1dffbe template: SG500X_48P name: SG500X_48P groups: - name: Templates items: ... valuemaps: ... graphs: ...模板被归入Templates组模板技术名与显示名均为SG500X_48P。导入方式为标准 Zabbix 流程前端Data collection → Templates → Import选择对应版本的 YAML/XML 文件即可。由于模板内部未定义任何宏SNMP 认证依赖 Zabbix 内置的{$SNMP_COMMUNITY}宏默认值为public或主机层自定义宏因此部署前请确认交换机实际配置的 SNMP 团体名community string并据此调整主机宏否则 SNMP 监控项将返回Not supported。监控项Items全景解读模板共定义 23 个监控项下文按功能主题分组解读并给出 YAML 中的实际配置OID、更新间隔、预处理与单位。1. 可用性与延迟Simple check监控项类型Key更新间隔说明PingSimple checkicmpping30sICMP 可达性返回 1可达/ 0不可达值类型 FLOATPing por SegundoSimple checkicmppingsec30sICMP 往返时间秒值类型 FLOAT这两个项目依赖 Zabbix Server 的 fping 组件与 ICMP 权限。icmppingsec返回的是往返延迟秒数用于生成延迟折线图icmpping用于生成可用性折线图。二者共同构成模板对交换机存活状态的实时感知。2. 系统资源CPU、温度与运行时长监控项类型Key / OID更新间隔预处理与单位CPUSNMP agent.1.3.6.1.4.1.9.9.109.1.1.1.1.5120sunits:CTemperaturaSNMP agentkey:entPhySensorValue.68420481OID:.1.3.6.1.4.1.9.6.1.101.83.2.1.1.1.4.68420481120sunits:CTempo LigadoSNMP agentkey:system.uptimeOID:DISMAN-EVENT-MIB::sysUpTimeInstance60sMULTIPLIER× 0.01units:sCPUOID 位于 Cisco 私有 MIB 的 process 分支.1.3.6.1.4.1.9.9.109按 CISCO-PROCESS-MIB 的通用定义该 OID 末位.5对应 CPU 利用率 5 分钟平均值cpmCPUTotal5minRev。需注意模板将该项目单位设置为C摄氏度从语义上看 CPU 利用率更应使用%导入后建议按实际展示需求修正单位。Temperatura实体索引68420481对应机箱温度传感器snmp_oid 指向 Cisco 私有环境监控 OID.1.3.6.1.4.1.9.6.1.101.83.2.1.1.1.4结构对应 entPhySensorValue单位C合理。Tempo LigadoDISMAN-EVENT-MIB::sysUpTimeInstance的单位是百分之一秒1/100 s因此通过MULTIPLIER× 0.01 转换为秒并设置单位s历史保留 7d。3. 风扇状态Cooler / FAN模板为 6 个风扇分别定义监控项全部为 SNMP agent 类型更新间隔 600s10 分钟历史保留 7d监控项Keysnmp_oidYAMLFan 01rlEnvMonFanState.67109250.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109249Fan 02rlEnvMonFanState.67109251.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109250Fan 03rlEnvMonFanState.67109252.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109251Fan 04rlEnvMonFanState.67109253.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109252Fan 05rlEnvMonFanState.67109254.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109253Fan 06rlEnvMonFanState.67109255.1.3.6.1.4.1.9.6.1.101.83.1.1.1.3.67109254这些 OID 属于 Cisco 环境监控私有分支.1.3.6.1.4.1.9.6.1.101.83末尾.1.1.1.3结构对应 rlEnvMonFanState风扇状态对象实体索引67109249~67109254由设备固件分配。从源码结构看Fan 项目的snmp_oid 与 key 的实体索引存在 1 位错位例如 Fan 01 的 OID 末位为 67109249而 key 为rlEnvMonFanState.67109250。由于 Zabbix 的 SNMP agent 类型监控项实际以snmp_oid字段采集key 仅作为内部标识采集本身不受影响但排查问题时需留意这一不一致。风扇状态值由交换机固件定义如正常 / 警告 / 故障等枚举模板本身未为该系列监控项配置值映射也未定义风扇告警触发器如需将状态数值翻译为可读文本并告警建议参考下文扩展建议。4. 端口流量Tráfego模板对两个端口分别采集入向/出向流量共 4 个监控项更新间隔 60s监控项Key / OID预处理链单位Tráfego de entrada GigabitEthernet 1/1/1ifInOctets.49CHANGE_PER_SECOND→MULTIPLIER× 8bTráfego de saída GigabitEthernet 1/1/1ifOutOctets.49CHANGE_PER_SECOND→MULTIPLIER× 8bTráfego de entrada Tengigabitethernet 1/1/1ifInOctets.107CHANGE_PER_SECOND→MULTIPLIER× 8bTráfego de saída Tengigabitethernet 1/1/1ifOutOctets.107CHANGE_PER_SECOND→MULTIPLIER× 8bYAML 中的完整预处理定义为preprocessing: - type: CHANGE_PER_SECOND parameters: - - type: MULTIPLIER parameters: - 8这段链路是模板中最值得关注的数据处理逻辑ifInOctets/ifOutOctets是 IF-MIB 的累计计数器自启动以来的字节数第一步CHANGE_PER_SECOND将其转换为每秒增量即速率第二步MULTIPLIER × 8将字节/秒换算为比特/秒1 字节 8 比特最终以单位bbit呈现供Tráfego de entrada / Tráfego de saída两张图表直接绘制带宽曲线。若希望以字节为单位展示只需删除第二步即可。5. 端口错误包Pacotes com erro模板为两个端口分别采集入向/出向错误包共 4 个监控项更新间隔 60s监控项Key / OID预处理单位Pacotes de entrada com erro GigabitEthernet 1/1/1ifInErrors.49CHANGE_PER_SECONDpacketsPacotes de saída com erro GigabitEthernet 1/1/1ifOutErrors.49CHANGE_PER_SECONDpacketsPacotes de entrada com erro Tengigabitethernet 1/1/1ifInErrors.107CHANGE_PER_SECONDpacketsPacotes de saída com erro Tengigabitethernet 1/1/1ifOutErrors.107CHANGE_PER_SECONDpacketsifInErrors表示入向报文中因错误无法递交高层协议的数量ifOutErrors表示出向传输失败的报文数量二者同样是累计计数器因此通过CHANGE_PER_SECOND转换为每秒错误包速率单位为packets。错误包速率持续升高通常是链路质量劣化CRC 错误、超限帧等的早期信号。6. 端口状态、速率与 MTU监控项Key / OID更新间隔预处理与单位历史保留Estado operacional GigabitEthernet 1/1/1IF-MIB::ifOperStatus.4960s值映射SNMP interface status (ifOperStatus)7dVelocidade da Porta GigabitEthernet 1/1/1IF-MIB::ifSpeed.4960sMULTIPLIER× 1units:bps7dVelocidade da Porta Tengigabitethernet 1/1/1IF-MIB::ifSpeed.10760sMULTIPLIER× 1units:bps7dVelocidade Porta GigabitEthernet 1/1/1 MTUIF-MIB::ifMtu.4960sMULTIPLIER× 1,000,000units:b2dVelocidade Porta Tengigabitethernet 1/1/1 MTUIF-MIB::ifMtu.10760sMULTIPLIER× 1,000,000units:b2difOperStatus接口操作状态模板通过值映射valuemap将 RFC 1213 定义的状态码翻译为可读文本见下节用于实时掌握端口 up/down 状态。ifSpeed接口当前带宽估计值单位为 bits per secondbps模板中MULTIPLIER × 1属于冗余预处理不影响结果。ifMtu接口最大传输单元字节。需特别提示模板为其配置了MULTIPLIER × 1,000,000并将单位设为b。从语义上看MTU 是字节数如 1500通常无需放大该预处理会把原始值放大百万倍疑似作者将 MTU 误当作速率处理。若你希望图表展示真实 MTU 数值建议删除此预处理步骤后再使用。值映射ifOperStatus 状态机模板在valuemaps节定义了一个名为SNMP interface status (ifOperStatus)的值映射作用于Estado operacional GigabitEthernet 1/1/1监控项将 IF-MIB 标准状态码映射为可读文本原始值映射文本1up2down3testing4unknown5dormant6notPresent7lowerLayerDown该映射完整覆盖 RFC 2863 中 ifOperStatus 的全部 7 种状态。结合 Zabbix 的触发器表达式如last()2表示 down可以在此基础上构建端口掉线告警。图形化展示Graphs模板共定义 11 张图形将上述监控项组织为便于直接投放到仪表盘的视图。YAML 中graphs节的完整清单如下图形名称包含监控项绘制样式 / 颜色Cooler ( FAN )Fan 01~06BOLD_LINE六色区分1A7C11 / F63100 / 2774A4 / A54F10 / FC6EA3 / 6C59DCCPUCPUGRADIENT_LINEA54F10DisponibilidadePingicmppingGRADIENT_LINE1A7C11LatenciaPing por SegundoicmppingsecGRADIENT_LINE1A7C11Pacotes de entrada com erroifInErrors.49 / ifInErrors.107双线1A7C11 / F63100Pacotes de saída com erroifOutErrors.49 / ifOutErrors.107双线F63100 / 1A7C11Tempo Ligadosystem.uptimeGRADIENT_LINE1A7C11Tráfego de entradaifInOctets.49 / ifInOctets.107双线1A7C11 / F63100Tráfego de saídaifOutOctets.49 / ifOutOctets.107双线F63100 / 1A7C11Velocidade da PortaifSpeed.49 / ifSpeed.107双线F63100 / 1A7C11Velocidade Porta MtuifMtu.49 / ifMtu.107双线1A7C11 / F63100其中Cooler ( FAN )图以粗线BOLD_LINE叠加 6 个风扇状态曲线便于在同一时间轴上对比各风扇状态流量类图形将千兆口.49与万兆口.107以双色曲线同图对比可直观看出上行口与接入口的带宽差异。导入模板后这些图形会以SG500X_48P: 图形名的形式自动出现在主机图形列表中。使用前提与注意事项基于模板源码以下限制与前提需要在部署前确认OID 与索引硬编码端口ifIndex 49 / 107与风扇/温度实体索引67109249~67109254、68420481均为固定值。它们由交换机固件分配不同型号、不同固件版本可能不同。部署前建议用snmpwalk核对实际索引例如snmpwalk -v2c -c community switch-ip .1.3.6.1.4.1.9.6.1.101.83.1.1.1.3 snmpwalk -v2c -c community switch-ip IF-MIB::ifName若索引不一致需要逐个修改模板监控项的 OID 与 key。监控范围固定模板只覆盖GigabitEthernet 1/1/1与Tengigabitethernet 1/1/1两个端口。SG500-48P 拥有 48 个千兆口与 4 个万兆口其余端口不在默认监控范围内如需全端口覆盖应引入自动发现见下文扩展建议。无触发器README 与 YAML 均确认模板没有定义任何触发器There are no triggers。这意味着模板只完成数据采集与图形化不会产生任何告警。风扇故障、端口 down、温度越限都需要自行补充触发器表达式。无宏、无模板链接、无发现规则模板不依赖宏和链接模板也不使用 LLD所有项目均为静态定义结构简单、导入即用但灵活性有限。预处理语义偏差CPU 单位被设为C、ifMtu 被乘以 1,000,000、Fan 项目 snmp_oid 与 key 索引错位均属模板原始配置中的细节瑕疵建议按前述说明逐一核对与修正。扩展建议向 LLD 与告警能力演进若需在 SG500 系列上获得更强的监控能力仓库中同目录下的兄弟模板 template_cisco_sg500x-48p6.0 提供了可借鉴的成熟思路其配套 YAML 位于 template_cisco_sg500x-48p.yamlLLD 自动发现该模板通过rlPhdUnitEnvParamStackUnit环境堆叠单元与ifName网络接口两条发现规则自动为每个堆叠单元和每个接口生成监控项覆盖全部端口而非仅两个固定口并自动生成固件版本、序列号、Service Tag 等资产信息。告警触发器该模板内置了完整的告警体系可直接移植到 SG500X_48P 模板上例如风扇状态6→ criticalaverage 级、avg(#3)6→ failedhigh 级、avg(#3)2→ warningwarning 级温度状态3→ criticaldisaster 级、2→ highhigh 级入向/出向流量 5 分钟均值超过ifHighSpeed × 0.8→ warning80% 带宽水位告警ifOperStatus连续两次采样均为2→ 链路中断disaster 级。将这些触发器表达式中的主机名与项目 key 替换为 SG500X_48P 模板对应的 key如rlEnvMonFanState.67109250、ifInOctets.49等即可在不改造原模板结构的前提下获得完整的告警闭环。总结SG500X_48P 是一个典型的轻量级、零依赖社区模板23 个静态 SNMP/ICMP 监控项 1 个 ifOperStatus 值映射 11 张图形覆盖了 Cisco SG500 系列交换机日常运维中最关心的风扇、温度、CPU、可用性、延迟、流量与错误包指标导入即可采集、开箱即见图形。它的主要短板——无触发器、端口硬编码、预处理语义瑕疵——恰好是读者在实战中应当补齐与修正的重点。结合仓库内同系列的 LLD 模板思路template_cisco_sg500x-48p你可以低成本地将这套基础监控扩展为全端口自动发现、带完整分级告警的生产级方案。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐BingGPT视觉设计解析从图标到配色的设计理念BingGPT视觉设计解析从图标到配色的设计理念 BingGPT作为一款跨平台的AI聊天桌面应用Windows、macOS和Linux其视觉设计不仅承载使用 Zabbix 社区模板「XSM SNMP Devices」监控 Cisco SGE2000P 交换机全量接口、风扇、温度与延迟监控实战使用 Zabbix 社区模板「XSM SNMP Devices」监控 Cisco SGE2000P 交换机全量接口、风扇、温度与延迟监控实战 本篇文章围绕 ZZabbix 官方 SNMP 监控模板解析Cisco Catalyst 3750V2-48TS 交换机全量监控方案Zabbix 官方 SNMP 监控模板解析Cisco Catalyst 3750V2 48TS 交换机全量监控方案 本篇文章以 Zabbix 开源仓库中 Ci指标监控可观测性告警运维上一篇八大网盘直链解析神器免费高速下载的终极解决方案下一篇八大网盘直链获取工具告别下载限制的智能解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
