指标监控可观测性告警运维【免费下载链接】zabbixReal-time monitoring of IT components and services, such as networks, servers, VMs, applications and the cloud.项目地址https://gitcode.com/gh_mirrors/zabbix2/zabbix点击查看免费下载本指南以 Zabbix 官方模板ZYXEL XGS-4728F by SNMP位于 templates/net/zyxel_snmp/zyxel_xgs-4728f_snmp/为核心完整讲解该模板的部署前提、宏体系、监控项、低级别发现LLD、触发器、图表与资产入库机制并结合仓库中 SNMP 轮询与界面配置的源码实现说明其底层原理。读完本文你将能够独立导入并配置该模板理解每一类宏的过滤作用掌握风扇、温度、电压、端口、SFP/DDM、内存池等 LLD 规则的采集逻辑并知道在设备存在 SNMP bulk 缺陷时如何正确规避。模板概览与适用前提该模板用于通过 SNMP 协议实时监控 ZYXEL XGS-4728F 三层万兆交换机属于 Zabbix 官方 Templates/Network devices 模板组见 template 定义。模板配套的官方说明文档为 README.md机器可读的完整导入文件为 template_net_zyxel_xgs-4728f_snmp.yaml。模板依赖以下 MIB均在该 YAML 的模板描述中列出MIB用途RFC1213-MIB系统标识、联系人、主机名、位置、网络运行时间sysUpTimeHOST-RESOURCES-MIB硬件运行时间hrSystemUptimeZYXEL-XGS4728F-MIB厂商私有 OID固件版本、序列号、CPU/内存、风扇、温度、电压、端口、SFP/DDMIF-MIB端口 MAC、描述、管理/运行状态、收发流量与包计数、链路速率版本要求与测试版本Zabbix 版本8.0 及以上README 的 Requirements 部分明确写出 Zabbix version: 8.0 and higher。测试版本模板已在固件V4.00(BBC.2)C0_20190730发布于 2019-07-30上完成验证。厂商配置README 要求 SNMP 相关配置社区字符串、SNMP 版本等以厂商文档为准Refer to the vendor documentation。已知问题SNMP bulk 请求处理缺陷部署前必读README 与模板 YAML 的 Known Issues 部分都明确记录了一个固件缺陷描述设备对 SNMP bulk 请求处理不正确需要在 SNMP 接口设置中禁用 bulk 请求的使用。影响版本全部固件版本。设备ZYXEL XGS-4728F。该提示并非空穴来风仓库源码可以印证 bulk 与普通 get 请求在轮询路径上的实质区别。Zabbix 的 SNMP 轮询在 checks_snmp.c 中根据配置选择 PDU 类型if (ZBX_IF_SNMP_VERSION_1 item-snmp_version) /* GetBulkRequest-PDU available since SNMPv2 */ bulk SNMP_BULK_DISABLED; ... pdu snmp_pdu_create(SNMP_BULK_ENABLED bulk ? SNMP_MSG_GETBULK : SNMP_MSG_GETNEXT);即启用 bulk 时走SNMP_MSG_GETBULKv2c/v3 才支持禁用时退化为逐条SNMP_MSG_GETNEXT。对于本模板使用的多个discovery[...]表遍历与多 OIDget[...]bulk 会显著放大单次请求的变量数。若设备固件对 bulk 响应处理有缺陷会导致轮询超时或数据错乱这正是模板要求禁用 bulk的原因。在 Zabbix 前端禁用方式主机 → 主机接口 → SNMP 接口 → 取消勾选 Use bulk requests。后台 API 对bulk字段的取值校验仅允许SNMP_BULK_DISABLED/SNMP_BULK_ENABLED可以在 CHostInterface.php 中看到。部署与初始化配置官方模板属于 Templates out of the box开箱即用模板部署流程如下将 template_net_zyxel_xgs-4728f_snmp.yaml 导入 Zabbix数据采集 → 模板 → 导入。确认设备侧已按厂商文档开启 SNMP 服务并配置好版本、社区字符串/安全凭据。新建主机将ZYXEL XGS-4728F by SNMP模板链接到主机。配置主机的 SNMP 接口IP/DNS、端口 161、SNMP 版本并根据上文已知问题取消勾选 Use bulk requests。根据实际网络环境在主机或模板层面覆盖下文所述的宏尤其各LLD.FILTER宏。模板宏体系详解模板共定义了 14 个用户可调宏按功能分为阈值Thresholds过滤器Filters其他Other三组分组、优先级与正则校验见 YAML macros 段。阈值类宏宏默认值说明{$CPU.UTIL.CRIT}90CPU 利用率告警阈值%取值范围 0100{$MEMORY.UTIL.MAX}90内存池利用率告警阈值%取值范围 0100{$SNMP.TIMEOUT}5mSNMP 代理可用性触发表达式的时间窗口{$SNMP.UPTIME.WARN}10m主机已重启问题自动恢复的运行时间阈值其中{$CPU.UTIL.CRIT}与{$MEMORY.UTIL.MAX}在 YAML 中带有^-?([0-9]|(([0-9])\.([0-9])))$正则校验只允许合法数值。接口发现过滤器宏默认值说明{$ZYXEL.LLD.FILTER.IF.NAME.MATCHES}.*按可发现的接口名称过滤包含{$ZYXEL.LLD.FILTER.IF.NAME.NOT_MATCHES}CHANGE_IF_NEEDED按接口名称排除不匹配{$ZYXEL.LLD.FILTER.IF.LINKUPTYPE.MATCHES}1\|2按可发现的链路类型过滤0-Down link、1-Cooper link铜缆、2-Fiber link光纤{$ZYXEL.LLD.FILTER.IF.LINKUPTYPE.NOT_MATCHES}CHANGE_IF_NEEDED按链路类型排除{$ZYXEL.LLD.FILTER.IF.CONTROL.MATCHES}CHANGE_IF_NEEDED仅对描述包含该值的接口创建触发器配合 LLD override 使用SFP 相关过滤器与采集间隔宏默认值说明{$ZYXEL.LLD.FILTER.SFP.STATUS.MATCHES}1\|2按 SFP 状态过滤0-OK with DDM、1-OK without DDM、2-nonoperational{$ZYXEL.LLD.FILTER.SFP.STATUS.NOT_MATCHES}CHANGE_IF_NEEDED按 SFP 状态排除{$ZYXEL.LLD.FILTER.SFPDDM.DESC.MATCHES}.*按可发现的 SFP DDM 参数名过滤{$ZYXEL.LLD.FILTER.SFPDDM.DESC.NOT_MATCHES}N/A按 SFP DDM 参数名排除{$ZYXEL.LLD.SFP.UPDATE}10mSFP 模块数据采集间隔。模板明确提示从 SFP 模块读取数据较慢不建议小于 10 分钟所有CHANGE_IF_NEEDED占位值都要求使用者按实际环境替换否则对应的过滤/排除条件不会生效。核心监控项Items与预处理逻辑模板的静态监控项非 LLD共 10 个键名前缀统一为zyxel.4728f.*。以下为完整清单SNMP OID 与预处理细节取自 YAML items 段监控项名称类型键OID预处理资产字段SNMP agent availabilityZabbix internalzabbix[host,snmp,available]——值映射 SNMP available—Hardware model nameSNMP agentzyxel.4728f.model1.3.6.1.2.1.1.1.0Discard unchanged6hMODELContactSNMP agentzyxel.4728f.contact1.3.6.1.2.1.1.4.0Discard unchanged6hCONTACTHost nameSNMP agentzyxel.4728f.name1.3.6.1.2.1.1.5.0Discard unchanged6hNAMELocationSNMP agentzyxel.4728f.location1.3.6.1.2.1.1.6.0Discard unchanged6hLOCATIONMAC addressSNMP agentzyxel.4728f.mac1.3.6.1.2.1.2.2.1.6.1Discard unchanged6hMACADDRESS_AUptime (network)SNMP agentzyxel.4728f.net.uptime1.3.6.1.2.1.1.3.0Custom multiplier0.01单位 uptime—Uptime (hardware)SNMP agentzyxel.4728f.hw.uptime1.3.6.1.2.1.25.1.1.0Check for not supported失败置 0 multiplier0.01—ZyNOS F/W VersionSNMP agentzyxel.4728f.fwversiondiscovery[{#SNMP.ARRAY},1.3.6.1.4.1.890.1.5.8.46.1]JavaScript 拼装 Discard unchanged1dSOFTWARE_FULLHardware serial numberSNMP agentzyxel.4728f.serialnumber1.3.6.1.4.1.890.1.5.8.46.1.10.0Discard unchanged6hSERIALNO_ACPU utilizationSNMP agentzyxel.4728f.cpuusage1.3.6.1.4.1.890.1.5.8.46.12.7.0无单位 %—几个值得注意的实现细节单位换算两个 uptime 项都通过MULTIPLIER 0.01把 SNMP 的百分之一秒计数换算为秒并统一使用uptime单位展示。网络 uptime 来自 RFC1213-MIB 的 sysUpTime硬件 uptime 来自 HOST-RESOURCES-MIB 的 hrSystemUptime——后者才是真正反映整机启动时长的计数器README 中特别指出二者含义不同。错误兜底硬件 uptime 使用CHECK_NOT_SUPPORTED-1CUSTOM_VALUE 0的错误处理即设备不支持该 OID 时置为 0避免监控项进入 not supported 状态。固件版本组装zyxel.4728f.fwversion通过discovery[{#SNMP.ARRAY}, ...]一次性读取固件 OID 子树再用 JavaScript 把散落的固件组成部分拼成V{主}.{次}({补丁}.{小补丁})_{日期}格式见 YAML 中的JAVASCRIPT预处理并配合DISCARD_UNCHANGED_HEARTBEAT 1d降低写入频率。Discard unchanged with heartbeat系统标识类字段模型、联系人、主机名、位置、MAC、序列号均使用6h心跳的未变化即丢弃预处理显著减少历史存储开销这类数据理论上一天才需确认一次但对资产同步又足够及时。低级别发现LLD规则体系模板的核心价值在于 7 条 SNMP LLD 规则它们把设备上的风扇、温度、电压、端口、SFP 模块与内存池动态映射为监控项。所有发现规则的默认轮询间隔为1hSFP 相关两条为12h数据项继承{$ZYXEL.LLD.SFP.UPDATE}即 10m。Fan discovery风扇发现 OID1.3.6.1.4.1.890.1.5.8.46.9.1.1.5同时带回{#ZYXEL.FANRPM.THRESH.LOW}低速告警阈值。原型项zyxel.4728f.fan[{#SNMPINDEX}]单位!rpm采集...9.1.1.2.{#SNMPINDEX}。原型触发器last(...fan[{#SNMPINDEX}]) {#ZYXEL.FANRPM.THRESH.LOW}Average 级别。图形原型ZYXEL XGS-4728F: Fan #{#SNMPINDEX}。Temperature discovery温度发现 OID...9.2.1.5带{#ZYXEL.TEMP.THRESH.HIGH}高温阈值。JavaScript 预处理把索引映射为可读名称{1:MAC, 2:CPU, 3:PHY}生成{#ZYXEL.TEMP.ID}。原型项zyxel.4728f.temp[{#SNMPINDEX}]单位!°C。原型触发器last(...) {#ZYXEL.TEMP.THRESH.HIGH}Average 级别提示 Please check the temperature。Voltage discovery电压发现 OID...9.3.1.6与...9.3.1.5带{#ZYXEL.VOLT.THRESH.LOW}低压阈值与{#ZYXEL.VOLT.NOMINAL}标称电压。JavaScript 预处理把原始毫伏值格式化为12V之类的标称名并把阈值除以 1000 换算为伏特。原型项zyxel.4728f.volt[{#SNMPINDEX}]单位 Vmultiplier0.001。原型触发器last(...) {#ZYXEL.VOLT.THRESH.LOW}Average 级别提示 Please check the power supply。Interface discovery接口/端口发现 OID...23.1.1.3接口描述与...23.1.1.5链路类型带{#ZYXEL.IF.NAME}与{#ZYXEL.IF.LINKUPTYPE}宏。发现过滤器evaltype: AND组合{#ZYXEL.IF.LINKUPTYPE}与{#ZYXEL.IF.NAME}的 MATCHES / NOT_MATCHES 条件分别引用上述{$ZYXEL.LLD.FILTER.IF.*}宏。LLD overrideDont create triggers for matching interface——对{#ZYXEL.IF.NAME}不匹配{$ZYXEL.LLD.FILTER.IF.CONTROL.MATCHES}的接口禁用全部触发器原型实现只对关键端口告警的精细化控制。原型项多达 17 个覆盖收发流量/单播/组播/广播包速率、链路速率multiplier1000000得到 bps、接口描述、链路类型、速度双工、管理/运行状态以及两个 Calculated 类型利用率项。利用率计算zyxel.4728f.net.if.in.util[{#SNMPINDEX}]为 Calculated 项表达式为last(//zyxel.4728f.net.if.in.traffic[{#SNMPINDEX}]) * (last(//zyxel.4728f.net.if.highspeed[{#SNMPINDEX}]) 0) / ( last(//zyxel.4728f.net.if.highspeed[{#SNMPINDEX}]) (last(//zyxel.4728f.net.if.highspeed[{#SNMPINDEX}]) 0) ) * 100通过布尔相乘/相加技巧规避除零再经IN_RANGE 0→100失败丢弃与 JS 四舍五入预处理。出方向同理。原型触发器ZYXEL: Port {#SNMPINDEX}: Link down——operstatus 2 且当前值与上一值不同即发生由 up 变 down的边沿变化带恢复表达式last(...)2Average 级别、手动关闭。SFP without DDM discovery无 DDM 光模块发现 OID...117.1.1.2带{#ZYXEL.SFP.STATUS}过滤器按{$ZYXEL.LLD.FILTER.SFP.STATUS.*}宏默认只发现1|2即 OK without DDM 与 nonoperational。原型项Status值映射、Vendor、Part number、Serial number、Revision、Date code、Transceiver采集间隔统一为{$ZYXEL.LLD.SFP.UPDATE}10m。原型触发器ZYXEL: SFP {#SNMPINDEX} has been replaced——序列号变化即告警Info 级别、手动关闭用于发现光模块被更换。SFP with DDM discovery带 DDM 光模块发现 OID...117.2.1.5WARN.MAX、...117.2.1.6WARN.MIN、...117.2.1.8参数描述。JavaScript 预处理完成多项数据整形把{#SNMPINDEX}拆出端口号{#ZYXEL.SFP.PORT}根据参数名Temperature/Voltage/TxBias/TxPower/RxPower映射单位{#ZYXEL.SFP.UNIT}°C/V/mA/dbm/dbm把上/下告警阈值除以 100。原型项zyxel.4728f.sfp.ddm[{#SNMPINDEX}]multiplier0.01单位!{#ZYXEL.SFP.UNIT}间隔{$ZYXEL.LLD.SFP.UPDATE}。原型触发器两条 {#ZYXEL.SFP.WARN.MAX}High与 {#ZYXEL.SFP.WARN.MIN}LowWarning 级别、手动关闭——即对光模块温度、电压、偏置电流、发射/接收光功率的上限/下限双向告警。Memory pool discovery内存池发现 OID...124.1.1.2带{#ZYXEL.MEMORY.NAME}。原型项zyxel.4728f.memory[{#SNMPINDEX}]单位 %Discard unchanged1h。原型触发器min(...,5m) {$MEMORY.UTIL.MAX}Average 级别提示系统可用内存不足。触发器体系从设备级到端口级模板的触发器分为设备级6 条与 LLD 原型级若干条两类。设备级触发器触发器严重性表达式要点ZYXEL: No SNMP data collectionWarningmax(zabbix[host,snmp,available],{$SNMP.TIMEOUT})0提示检查设备连通性与 SNMP 设置ZYXEL: Template does not match hardwareInfomodel XGS-4728F防止模板误挂到其他型号设备ZYXEL: Host has been restartedInfo手动关闭双分支检测 hw.uptime 或 net.uptime 计数器回退并用42949672.962^32 百分之一秒 ≈ 497 天判断是否属于 32 位计数器回绕而非真实重启恢复表达式为 uptime 超过{$SNMP.UPTIME.WARN}ZYXEL: Firmware has changedInfo手动关闭fwversion #1 #2且长度 0固件变化后需人工确认关闭ZYXEL: Device has been replacedInfo手动关闭serialnumber #1 #2且长度 0识别整机被替换ZYXEL: High CPU utilizationWarningmin(cpuusage,5m) {$CPU.UTIL.CRIT}Host has been restarted 的完整表达式同时覆盖两种取值路径硬件 uptime 可用0时看zyxel.4728f.hw.uptime不可用0即设备不支持 hrSystemUptime时回退看网络 uptime这与其监控项的错误兜底预处理设计是一一对应的见 YAML triggers 段。原型级触发器即上文各 LLD 章节所列风扇/温度/电压临界Average、端口 Link downAverage、SFP 更换Info、DDM 高低阈值Warning、内存池高利用率Average。数据可视化与资产入库图形设备级ZYXEL XGS-4728F: CPU utilizationY 轴固定 0100渐变线原型级有风扇、温度、电压单值图端口级有 Traffic进/出流量、Packets traffic单播/组播/广播六条线、Utilization进/出利用率三张图。仪表盘模板自带 Network interfaces 仪表盘原型直接嵌入端口 Traffic 图形组件主机链接模板后即可获得可视化页面。值映射模板定义了 6 个值映射将原始整数翻译为可读文本——SNMP available0/1/2、端口链路类型Down/Cooper/Fiber/XFP/CX4、速度双工auto、10M half/full、100M half/full、1G full、端口管理状态Up/Down/Testing、端口运行状态17 完整 IF-MIB 枚举、SFP 状态OK with DDM / OK without DDM / nonoperational。资产字段系统标识类监控项分别映射到 MODEL、CONTACT、NAME、LOCATION、MACADDRESS_A、SERIALNO_A、SOFTWARE_FULL可自动同步到主机资产清单inventory页面。实战调优建议结合上述机制落地时建议按以下顺序调整先处理 bulk 缺陷给 XGS-4728F 主机的 SNMP 接口取消勾选 Use bulk requests这是官方明确要求的必要步骤。收紧 LLD 过滤器把{$ZYXEL.LLD.FILTER.IF.NAME.MATCHES}从.*改为实际纳管端口范围如^[0-9]$把{$ZYXEL.LLD.FILTER.IF.CONTROL.MATCHES}改为关键链路描述关键字避免为所有闲置端口创建触发器。按机房环境调整阈值{$CPU.UTIL.CRIT}、{$MEMORY.UTIL.MAX}依业务容忍度设置{$SNMP.TIMEOUT}建议不小于轮询间隔避免抖动误报。保持 SFP 采集间隔不要将{$ZYXEL.LLD.SFP.UPDATE}调到 10 分钟以下——模板明确说明 SFP/DDM 数据读取慢过短间隔只会堆积轮询负担。源码级原理补充SNMP 轮询与 bulk 的实现若想深入理解模板所依赖的采集通道可继续阅读 checks_snmp.c 中zbx_snmp_walk()与zbx_snmp_get_values()的实现SNMPv1 强制禁用 bulkSNMP_BULK_DISABLEDv2c/v3 才可能使用SNMP_MSG_GETBULK且max_repetitions max_vars。当单次请求过大时实现会采用迭代缩减请求规模的策略收到SNMP_ERR_TOOBIG或超时即逐步降低max_vars重试reduce_max_vars逻辑这与模板中多个discovery[...]大表遍历的健壮性直接相关。前端 API 对 SNMP 接口bulk字段的合法性校验与默认值v2c 默认启用 bulkv1 自动禁用在 CHostInterface.php 与 C20ImportConverter.php 中均有体现。故障排查与反馈若监控项长时间 not supported 或发现规则未产生数据请依次核对设备 SNMP 服务与凭据、社区字符串/安全级别、模板宏中的过滤器是否误排除了目标尤其 SFP 与链路类型过滤器、以及是否已按已知问题禁用 bulk。模板的官方 README 末尾附有 Feedback 说明Zabbix 官方提供问题上报与论坛反馈渠道具体入口可查阅 README.md。赞分享指标监控可观测性告警运维【免费下载链接】zabbixReal-time monitoring of IT components and services, such as networks, servers, VMs, applications and the cloud.项目地址https://gitcode.com/gh_mirrors/zabbix2/zabbix点击查看免费下载相关推荐Zabbix 8.0 监控 MikroTik CRS317-1G-16SRM 交换机官方 SNMP 模板深度解析Zabbix 8.0 监控 MikroTik CRS317 1G 16SRM 交换机官方 SNMP 模板深度解析 本指南围绕当前仓库中官方提供的「Mikro指标监控可观测性告警运维Zabbix 8.0 通过 SNMP 监控 MikroTik RB260GS 交换机官方模板全解析Zabbix 8.0 通过 SNMP 监控 MikroTik RB260GS 交换机官方模板全解析 本文以当前开源仓库 templates/net/mikro指标监控可观测性告警运维Zabbix 8.0 监控 MikroTik CRS326-24G-2SRM 交换机官方 SNMP 模板全解析Zabbix 8.0 监控 MikroTik CRS326 24G 2SRM 交换机官方 SNMP 模板全解析 本文档深入解析 Zabbix 官方开源模板库指标监控可观测性告警运维上一篇Actual 预算恢复实战指南从手动备份恢复到自动备份加载的完整方案下一篇3 条命令跑起私有 IPTV 播放器Docker 容器化部署实录创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考