使用 Zabbix「SNMP OLT FiberHome」模板监控 FiberHome 光纤 OLT 设备:发现规则、监控项与告警全解析 【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本篇技术指南围绕 Zabbix Community Templates 仓库中的SNMP OLT FiberHome模板展开介绍如何通过 SNMP 对 FiberHome烽火GEPON 光纤 OLT 设备进行全量监控。读完本文你将掌握该模板的五大 LLD 发现规则Card / MGMT Card / PON / ONU / 64 位接口、系统级监控项与外部检查脚本的用法、全部触发器的阈值语义以及如何在 Zabbix 5.0/5.4/6.0 中导入并使用这套模板。模板定位与适用场景该模板由社区作者 Jhakson Redfield 编写并提交至 community-templates 仓库模板全名为SNMP OLT FiberHome面向 FiberHome 系列 GEPON 光线路终端OLT设备。OLT 是 PON 网络的核心汇聚设备下挂大量 ONU/ONT 终端运维人员最关心三类指标板卡健康度各槽位 CPU / 内存 / 状态 / 版本、PON 口与 ONU 在线情况每 PON 口已认证 ONU 数量、ONU 光功率、以及上行口流量。仓库为同一模板维护了三个 Zabbix 版本适配文件内容一一对应Zabbix 版本模板文件格式5.0template_fiberhome_2020.xmlXML5.4template_fiberhome_2020.yamlYAML6.0template_fiberhome_2020.yamlYAML三份文件的导出内容模板 UUID8769e0d7e61f42a4a6b64ab35a11bedc保持一致5.0 版本因格式限制使用旧式{HOST:key.last()}触发器语法5.4 / 6.0 版本则统一使用新的last(/SNMP OLT FiberHome/key)函数语法。模板导入后归属FiberHome与Templates两个主机组模板自身定义在Templates组下。提示仓库中还有一份同主题但由其他作者维护的 template_olt_fiber_homer-pon1_a_pon8采用逐槽位硬编码 OID 的方式采集cardCpuUtil/cardMemUtil/oltPonOnlineStatus等数据适合槽位固定的场景而本模板全部走 LLD 自动发现槽位增减无需手工改配置二者可互为参照。模板导入方法按你的 Zabbix Server 版本选择对应文件5.0 用 XML5.4/6.0 用 YAML进入 Zabbix Web 界面Configuration → Templates → Import选择文件上传导入时勾选模板相关选项如需要可同时导入模板引用的 groups导入成功后在Configuration → Hosts中为目标 OLT 主机链接模板SNMP OLT FiberHome并将主机 SNMP 接口配置为 OLT 的管理地址等待发现规则首个执行周期见下文各规则的 Update 间隔后系统会自动创建对应监控项。模板本身未定义任何用户宏README 中 Macros used 一节明确标注无宏但外部检查监控项引用了 Zabbix 内置宏{$SNMP_COMMUNITY}其默认值为public。若 OLT 的 SNMP community 不是 public请在主机或模板级覆盖该宏。底层 OID 结构一切监控的基础从 5.4 YAML 定义 可以看到模板采集的数据全部集中在 FiberHome 私有企业 OID 前缀.1.3.6.1.4.1.5875.800之下并引用了GEPON-OLT-COMMON-MIB中的符号名。按功能划分为三个子表系统级标量.3.9.4.x.0软件版本.3、硬件版本.4、系统温度.5板卡表.3.9.2.1.1.x.{槽位号}.2板卡类型、.3硬件版本、.4软件版本、.5板卡状态、.6端口总数、.7可用端口数、.8CPU 利用率、.9内存利用率ONU 表.3.9.3.3.1.x.{索引}.2ONU 名称、.6ONU RX 光功率、.7ONU TX 光功率。模板用discovery[{#SNMPVALUE},OID]的方式枚举表索引把{#SNMPINDEX}作为实例标识回填到原型 OID 中实现发现即采集。五大发现规则Discovery Rules详解模板共定义 5 条 SNMP LLD 规则覆盖设备从板卡到终端侧的全部关键对象规则名称监控项 Key发现 OID更新间隔Card Info Tablecard.info.discoverydiscovery[{#SNMPVALUE},.1.3.6.1.4.1.5875.800.3.9.2.1.1.2]2hMGMT Card Info Tablemgmtcard.info.discoverydiscovery[{#SNMPVALUE},GEPON-OLT-COMMON-MIB::mgrCardType,{#IFOPERSTATUS},GEPON-OLT-COMMON-MIB::mgrCardWorkStatus]2hPON Info TableoltPonDescdiscovery[{#SNMPVALUE},GEPON-OLT-COMMON-MIB::oltPonDesc]1hONU Info TableonuPonInfoTablediscovery[{#SNMPVALUE},.1.3.6.1.4.1.5875.800.3.9.3.3.1.2]12h 每日 12:00–12:01Network interfaces 64ifDescr_64discovery[{#SNMPVALUE},IF-MIB::ifDescr]1hCard Info Table业务板卡自动发现以板卡类型列.3.9.2.1.1.2为发现依据{#SNMPINDEX}即槽位号。该规则派生 9 个监控项原型其中板卡类型与状态带有字段说明见 YAML 定义监控项原型OID 列更新间隔说明Card Type Slot [{#SNMPINDEX}].21d260EC2724EC2-X16384AC16其余取值参见板卡类型表Card Hardware Version.31d文本型不保留趋势Card Software Version.41d文本型不保留趋势Key 为cardSoftwateVersion保留原作者拼写Card Status.510m1normal0communication interrupt通信中断Card Num of Ports.61d端口总数Card Available Ports.71d可用端口数Card CPU Util.810m预处理 ×0.01单位 %Card Mem Util.910m预处理 ×0.01单位 %注意 CPU / 内存利用率在设备侧以 0–10000 的整数上报模板通过MULTIPLIER 0.01预处理转换为百分比光功率类指标同理。CPU / 内存保留 15d 历史与 90d 趋势版本类文本项不保留趋势以节省存储。MGMT Card Info Table管理卡专项监控专门针对 OLT 主控管理卡发现 OID 同时枚举类型与工作状态两列mgrCardTypemgrCardWorkStatus并通过过滤器{#IFOPERSTATUS} 1只保留处于正常状态的槽位见 YAML 定义。原型监控项MGMT Card CPU UtilMgmtCardCpuUtil10m×0.01%MGMT Card Mem UtilMgmtCardMemUtil10m×0.01%MGMT Card Hardware Version1d文本MGMT Card Software Version1d文本该规则同样附带一个名为 MGMT CPU/Mem SLOT {#SNMPINDEX} 的图形原型。PON Info Table每 PON 口 ONU 容量统计以GEPON-OLT-COMMON-MIB::oltPonDesc发现所有 PON 口每个 PON 口生成一个监控项oltPonAuthOnuNum[{#SNMPVALUE}]ONU Number每 20 分钟采集一次该 PON 口下已认证的 ONU 数量见 YAML 定义。该指标用于评估 PON 口容量水位与批量掉线的异常波动并配有同名图形原型 ONU Number {#SNMPVALUE}。ONU Info Table终端侧光功率与名称以 ONU 名称列.3.9.3.3.1.2发现全部 ONU派生 3 个监控项原型监控项原型OID 列更新间隔单位/处理ONU Name.21d文本不保留趋势ONU RX Power.61hdBm×0.01ONU TX Power.71hdBm×0.01该规则的发现更新间隔为12h;1m/1-7,12:00-12:01即每 12 小时执行一次发现同时每天 12:00–12:01 额外执行 1 分钟用于及时捕获新增 ONU而 RX / TX 光功率本身保持 1 小时采集一次兼顾负载与实时性。光功率保留 1 周历史、60 天趋势并配有 Sinal ONU {#SNMPVALUE} 图形原型TX 为绿色、RX 为红色折线。Network interfaces 6464 位计数器上行口流量基于标准IF-MIB::ifDescr发现接口并设置过滤器{#SNMPVALUE}匹配FP见 YAML 定义。从过滤器可以推断该 OLT 的上行/汇聚口以FP开头命名模板据此只监控这些关键接口避免对成百上千个 PON 口逐一采集流量。每个接口生成一对 64 位计数器监控项Incoming traffic on interface $1 64bitsifHCInOctets[{#SNMPVALUE}]Outgoing traffic on interface $1 64bitsifHCOutOctets[{#SNMPVALUE}]两者均每 60 秒采集一次预处理链为CHANGE_PER_SECOND差值/秒后再MULTIPLIER 8字节转比特最终以bps为单位直接出图配套 Traffic on interface {#SNMPVALUE} 64bits 图形原型入向绿色渐变线、出向红色渐变线。系统级监控项与外部检查除 LLD 原型外模板还直接定义了 4 个常规监控项监控项Key类型更新间隔单位说明System Software VersionsysSoftVersionSNMP agent1d—OID.1.3.6.1.4.1.5875.800.3.9.4.3.0System Hardware VersionsysHardVersionSNMP agent1d—OID.1.3.6.1.4.1.5875.800.3.9.4.4.0System TemperaturesysTemperatureSNMP agent90s°COID.1.3.6.1.4.1.5875.800.3.9.4.5.0Clientes Total OLTclientes_OLT_FH.sh[{$SNMP_COMMUNITY}, {HOST.IP}]External check60s—统计整机在线 ONU 客户端总数其中Clientes Total OLT是模板中唯一的非 SNMP 监控项见 YAML 定义。它属于外部检查External check类型需要将配套脚本clientes_OLT_FH.sh部署到 Zabbix Server 的外部脚本目录通常为ExternalScripts配置项指定路径脚本接收两个参数{$SNMP_COMMUNITY}SNMP 团体名与{HOST.IP}被监控 OLT 的 IP通过 SNMP 汇总返回在线 ONU 数量监控项类型为 FLOAT归入ONU应用标签。README 与模板文件中均未附带该脚本本体因此部署时需要自行提供或根据 OID 表编写等价脚本。若该监控项显示 Not supported请优先检查脚本是否存在、是否可执行以及参数传递是否正常。触发器体系与告警阈值模板共定义 5 类触发器语义LLD 原型触发器 普通触发器合计 9 条全部集中在 5.4 YAML 的触发器原型定义 与 5.0 XML 对应节点 中触发器名称表达式恢复表达式优先级Slot #SNMPINDEX CPU is HIGHlast(cardCpuUtil)80last(cardCpuUtil)80highSlot #SNMPINDEX MEM is HIGHlast(cardMemUtil)80last(cardMemUtil)80highSlot #SNMPINDEX is Downlast(cardStatus)0无不自动恢复disasterONU Sinal is low ({ITEM.LASTVALUE}) on {#SNMPVALUE}avg(onuPonRXOpticalPower,10m)-25avg(...)-25warningSystem Temperature HIGH on {HOST.NAME}last(sysTemperature,#1:now-10m)55无averageDesconexao em Massa OLT(last(#2) - last()) 15无high各触发器的阈值设计要点CPU / 内存 80%触发 high 告警且配置了恢复表达式回落至 80% 以下自动恢复避免抖动反复告警板卡状态 0通信中断触发disaster级告警且不设置恢复表达式——板卡恢复在线后需要人工确认关闭告警ONU RX 光功率 10 分钟均值 ≤ -25 dBm触发 warning恢复条件为均值回升至 -25 dBm 以上。这是典型的 PON 光链路劣化判据配合{ITEM.LASTVALUE}宏可在告警消息中直接携带当前功率值系统温度 55°C触发 average表达式限定为最近 10 分钟内的最新值Desconexao em Massa OLTOLT 批量掉线是 YAML 中定义的隐藏触发器表达式为最近两次采集值之差大于 15(last(/SNMP OLT FiberHome/clientes_OLT_FH.sh[...],#2) - last(...)) 15。它通过检测在线 ONU 总数在 60 秒内的骤降一次掉线超过 15 台快速发现 PON 口或光模块故障导致的批量掉线事件优先级为 high。版本差异说明5.0 XML 中触发器使用旧式函数语法如{SNMP OLT FiberHome:cardCpuUtil.[{#SNMPINDEX}].last()}80与({prev()} - {last()}) 155.4 / 6.0 YAML 则统一为last(/SNMP OLT FiberHome/key)与#2偏移量写法语义等价。内置图形与可视化模板预置 2 张普通图形与 5 组图形原型导入后即可直接出图普通图形Clientes Total OLT在线 ONU 总数绿色粗线不显示工作时间段与触发器、System Temperature红色折线图形原型随 LLD 实例自动生成CPU/Mem SLOT {#SNMPINDEX}内存红色粗线 CPU 绿色渐变线、MGMT CPU/Mem SLOT {#SNMPINDEX}、Traffic on interface {#SNMPVALUE} 64bits入/出向流量、ONU Number {#SNMPVALUE}PON 口 ONU 数、Sinal ONU {#SNMPVALUE}TX 绿线 RX 红线。这样运维人员可以在一屏内同时看到槽位资源 接口流量 ONU 光功率三个维度的趋势无需额外手工建图。部署注意事项小结SNMP 可达性确保 Zabbix Server/Proxy 能通过 SNMP v2c 访问 OLT 管理地址community 与模板{$SNMP_COMMUNITY}宏一致默认public外部脚本clientes_OLT_FH.sh需自行部署到 Zabbix Server 外部脚本目录并保证可执行否则Clientes Total OLT及其批量掉线触发器不可用接口过滤器Network interfaces 64只发现名称以FP开头的接口若设备命名规则不同需调整该发现规则的过滤器条件版本对应5.0 使用 XML 文件5.4 / 6.0 使用 YAML 文件勿混用数据量控制ONU 数量较多的场景可通过修改ONU Info Table的发现间隔默认 12h 每日 1 分钟窗口与光功率采集间隔1h来平衡实时性与采集负载。通过本文的拆解可以看到SNMP OLT FiberHome模板将 FiberHome GEPON OLT 的板卡、PON 口、ONU 与上行流量完整纳入 Zabbix 的 LLD 体系阈值与图形开箱即用特别适合运营商与 ISP 场景下的 FTTH 接入网监控。若需自行扩展可参照 6.0 YAML 定义 在现有原型基础上追加 OID 列对应的监控项即可。赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix 监控烽火 FiberHome GEPON OLTSNMP OLT FiberHome 社区模板实战指南Zabbix 监控烽火 FiberHome GEPON OLTSNMP OLT FiberHome 社区模板实战指南 导读 本文围绕 Zabbix 社区模板仓使用 Zabbix LLD OLT ZTE 模板自动发现并监控 ZTE OLT 的 ONU 光功率与在线状态使用 Zabbix LLD OLT ZTE 模板自动发现并监控 ZTE OLT 的 ONU 光功率与在线状态 导读 本文基于 Zabbix 社区模板库中的 LLZabbix 监控 NetApp FAS3220官方 SNMP 模板部署、发现规则与告警策略全解析Zabbix 监控 NetApp FAS3220官方 SNMP 模板部署、发现规则与告警策略全解析 本文以 Zabbix 官方模板库中的 NetApp FAS指标监控可观测性告警运维上一篇INAV飞行控制5个关键步骤实现无人机稳定飞行下一篇网盘直链下载助手5分钟快速掌握浏览器下载网盘的终极方法创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考