Zabbix 7.0 监控 Juniper BGP 邻居:template_juniper_bgp_stats_by_snmp 模板深度解析与实战指南
Zabbix 7.0 监控 Juniper BGP 邻居:template_juniper_bgp_stats_by_snmp 模板深度解析与实战指南
导读
本文围绕 community-templates 仓库中的 template_juniper_bgp_stats_by_snmp 模板,系统讲解如何通过 SNMP-LLD(低级别发现)自动发现 Juniper 设备上的 IPv4/IPv6 BGP 邻居,并采集邻居状态(Peer State)、接收前缀数(PrefixesReceived)与过滤后接收前缀数(PrefixesAccepted)。读完本文,你将掌握该模板的发现机制、地址预处理原理、触发器与宏的调优方法,以及在生产环境部署时处理 snmp_parse_oid() 报错等关键技巧。
一、模板定位与核心思路
该模板由社区作者 change4826 贡献,作者仓库标注为 https://github.com/change48/zabbix_template(见 7.0 模板定义文件)。其核心设计思想是:
使用 SNMP-LLD 自动生成监控项,收集 BGP 邻居相关信息,包括邻居状态、接收的路由条目数量等数据。
与手工为每个邻居逐个创建监控项的传统做法相比,LLD 方式能在设备新增/删除 BGP 邻居时自动扩展或清理监控项,显著降低大规模骨干网、数据中心互联场景下的维护成本。
模板具备两大核心特性:
- 同时支持 IPv4 / IPv6 BGP 邻居;
- 内置预处理脚本,负责将 SNMP 返回的十六进制地址解析为可读文本,并对 IPv6 地址做缩写处理。
仓库同时提供 6.0 与 7.0 两个版本(分别位于 6.0 目录 与 7.0 目录)。6.0 版 README 说明该模板基于 Zabbix 6.4 制作,理论上支持 Zabbix 5.4 及以上版本,若导入遇到问题可尝试修改 version 字段;7.0 版则按 Zabbix 7.0 的 YAML 导出格式组织。
二、SNMP-LLD 发现机制解析
模板中唯一的发现规则(Discovery Rule)名为 bgp.info.base,类型为 SNMP_AGENT,键为 bgp.info.discovery,更新间隔为 1h(7.0 模板定义文件)。
2.1 发现 OID 与 LLD 宏
发现规则通过 discovery[] 语法一次性抓取多个 OID 列并映射为 LLD 宏:
discovery[{#PEERSTATE},1.3.6.1.4.1.2636.5.1.1.2.1.1.1.2,{#ADDRESSTYPE},1.3.6.1.4.1.2636.5.1.1.2.1.1.1.10,{#PEEREMOTEADDR},1.3.6.1.4.1.2636.5.1.1.2.1.1.1.11,{#PEERAS},1.3.6.1.4.1.2636.5.1.1.2.1.1.1.13,{#PEERINDEX},1.3.6.1.4.1.2636.5.1.1.2.1.1.1.14]
所有 OID 都位于企业私有 MIB 库 1.3.6.1.4.1.2636(Juniper 企业号)下的 jnxBgpM2 系列表中,各宏含义如下:
| LLD 宏 | OID | 含义 |
|---|---|---|
{#PEERSTATE} |
.1.3.6.1.4.1.2636.5.1.1.2.1.1.1.2 |
BGP 邻居 FSM 状态值(1~6) |
{#ADDRESSTYPE} |
.1.3.6.1.4.1.2636.5.1.1.2.1.1.1.10 |
地址族类型(1=IPv4,2=IPv6) |
{#PEEREMOTEADDR} |
.1.3.6.1.4.1.2636.5.1.1.2.1.1.1.11 |
对端地址(十六进制编码) |
{#PEERAS} |
.1.3.6.1.4.1.2636.5.1.1.2.1.1.1.13 |
对端自治系统号 ASN |
{#PEERINDEX} |
.1.3.6.1.4.1.2636.5.1.1.2.1.1.1.14 |
邻居索引(用于后续监控项 OID 拼接) |
2.2 LLD 过滤器:控制发现范围
发现规则内置了两条 AND 关系的过滤条件(模板定义文件):
{#PEERAS}不匹配{$IGNORE_ASN}:用于剔除指定 ASN 范围内的邻居(如本设备自身的 AS 或不想监控的对端);{#PEERSTATE}等于6:只保留处于established(已建立)状态的邻居,避免对尚未收敛的会话产生无效监控。
文档同时提示 {#PEEREMOTEADDR} 宏是可选的,当需要针对单个对端做精细化过滤时,可将其加入过滤器(例如 {#PEEREMOTEADDR} 匹配特定地址)。
发现产物的生存周期(lifetime)为 30d,且设置为 DISABLE_NEVER(不自动停用),意味着发现的邻居项会长期保留。
三、监控项原型(Item Prototypes)详解
模板通过三个监控项原型,为每个被发现的 BGP 邻居生成对应监控项:
| 监控项名称 | SNMP OID | 键(Key) | 说明 |
|---|---|---|---|
| BGP Peer {#PEEREMOTEADDR} - State | .1.3.6.1.4.1.2636.5.1.1.2.1.1.1.2.{#SNMPINDEX} |
jnxBgpM2PeerState.[{#PEERINDEX}] |
邻居邻接状态 |
| BGP Peer {#PEEREMOTEADDR} - PrefixesReceived count | .1.3.6.1.4.1.2636.5.1.1.2.6.2.1.7.{#PEERINDEX} |
jnxBgpM2PrefixInPrefixes.[{#PEERINDEX}] |
从特定邻居接收的路由条目总数 |
| BGP Peer {#PEEREMOTEADDR} - PrefixesAccepted count | .1.3.6.1.4.1.2636.5.1.1.2.6.2.1.8.{#PEERINDEX} |
jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}] |
接收并经策略过滤后实际生效的路由条数 |
三个监控项的含义与 README 中的描述一一对应(7.0 README):
- Peer State:BGP 邻居的邻接状态,经值映射(Valuemap)转换为可读文本;
- PrefixesAccepted count:从特定邻居接收、通过入方向路由策略过滤后真正被接受的路由条数;
- PrefixesReceived count:从特定邻居接收的全部路由条数(未经过滤的原始接收量)。
其中 PrefixesReceived 与 PrefixesAccepted 的差值,可直观反映入方向策略过滤掉了多少路由,是排查路由震荡与策略误配的重要指标。
3.1 BGP FSM 状态值映射
jnxBgpM2PeerState 监控项绑定了名为 BGP FSM state 的值映射(模板定义文件),将数字状态转为标准 BGP 有限状态机名称:
| 原始值 | 显示文本 |
|---|---|
| 1 | idle |
| 2 | connect |
| 3 | active |
| 4 | opensent |
| 5 | openconfirm |
| 6 | established |
映射后,Zabbix 前端展示的将是 idle、connect、established 等直观状态,而不是难以理解的数字。
3.2 图形原型
模板为 PrefixesAccepted count 生成了一条图形原型(Graph Prototype),名为 BGP Peer {#PEEREMOTEADDR} - PrefixesAccepted count,采用粗线(BOLD_LINE)绘制、颜色 0040FF(蓝色),使每个邻居的前缀接受量变化趋势一目了然。
四、数据预处理:IPv4/IPv6 十六进制地址转换
这是模板最精巧的部分。Junos 的 jnxBgpM2 MIB 将邻居地址以十六进制字符串形式返回(例如 IPv4 的 C0 A8 01 01、IPv6 的 20 01 0D B8 ...),无法直接作为监控项名称使用。模板在发现规则上挂载了一个 JavaScript 预处理步骤(模板定义文件),在 LLD 数据处理阶段完成地址解析:
4.1 IPv4 转换逻辑
function hexToIpAddress(hexString) {
var hexArray = hexString.trim().split(" ");
var ipArray = hexArray.map(function(hex) {
return parseInt(hex, 16);
});
return ipArray.join(".");
}
将空格分隔的十六进制字节逐个 parseInt(hex, 16) 转为十进制,再以点号连接。例如 C0 A8 01 01 → 192.168.1.1。
4.2 IPv6 转换与缩写逻辑
function hexToIpv6(hexString) {
var hexArray = hexString.trim().split(" ");
var ipv6 = [];
for (var i = 0; i < hexArray.length; i += 2) {
ipv6.push(hexArray[i] + hexArray[i + 1]);
}
return ipv6.join(":");
}
function abbreviateIpv6(ipv6Address) {
var addr = ipv6Address.replace(/(^|:)(0)+(?=:|$)/g, ':').replace(/:{3,}/g, '::');
return addr === '::' ? '0' + addr : addr;
}
IPv6 转换分两步:先把十六进制字节两两合并为 4 位十六进制段并用冒号连接(hexToIpv6),再通过正则完成 RFC 5952 风格的压缩缩写(abbreviateIpv6):
/(^|:)(0)+(?=:|$)/g去掉段内前导零;/:{3,}/g将连续冒号压缩为::;- 最后统一
toLowerCase()。
例如 2001:0db8:0000:0000:0000:0000:0000:0001 会被压缩为 2001:db8::1。
4.3 按地址族类型分发
json.forEach(function(obj) {
if (obj["{#ADDRESSTYPE}"] === "1") {
obj["{#PEERINDEX}"] += ".1.1";
obj["{#PEEREMOTEADDR}"] = hexToIpAddress(obj["{#PEEREMOTEADDR}"]);
} else if (obj["{#ADDRESSTYPE}"] === "2") {
obj["{#PEERINDEX}"] += ".2.1";
var ipv6Address = hexToIpv6(obj["{#PEEREMOTEADDR}"]);
obj["{#PEEREMOTEADDR}"] = abbreviateIpv6(ipv6Address).toLowerCase();
}
});
脚本根据 {#ADDRESSTYPE} 取值分流:1 按 IPv4 解析,2 按 IPv6 解析。关键细节:处理过程中还向 {#PEERINDEX} 追加了后缀——IPv4 追加 .1.1、IPv6 追加 .2.1。这是因为 Junos 的 jnxBgpM2 表中同一邻居可能同时存在 IPv4 与 IPv6 会话,通过后缀区分地址族,从而保证监控项键(Key)不会冲突。
五、触发器设计:状态告警与前缀突变检测
模板内置两条触发器原型(Trigger Prototypes),构成"状态基础告警 + 数值突变告警"的两级告警体系。
5.1 邻居状态变化触发器
表达式:last(/template_juniper_bgp_stats_by_snmp/jnxBgpM2PeerState.[{#PEERINDEX}]) <> 6 and last(/template_juniper_bgp_stats_by_snmp/jnxBgpM2PeerState.[{#PEERINDEX}],#2) <> 6
恢复表达式:last(/template_juniper_bgp_stats_by_snmp/jnxBgpM2PeerState.[{#PEERINDEX}])= 6 and avg(/template_juniper_bgp_stats_by_snmp/jnxBgpM2PeerState.[{#PEERINDEX}],5m) = 6
告警条件为:最新值与上一次取值都不等于 6(即连续两次采样均非 established 状态),可有效滤除单次采样抖动;恢复条件为最新值回到 6 且 5 分钟平均值稳定为 6。该触发器等级为未分类(unclassified),README 明确说明它是基础触发器,等级可按需自由调整。
5.2 PrefixesAccepted 突变触发器
该触发器用于捕捉前缀接受量在日同比与周同比两个时间维度上的异常波动,完整表达式如下(模板定义文件):
(last(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}]) <> 0
and last(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}]) >= {$ACCEPT_MIN})
and
((abs(last(...) - avg(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}],1h:now-1d))
/ avg(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}],1h:now-1d)) >= {$DIFF_RATIO})
and
((abs(last(...) - avg(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}],1h:now-1w))
/ avg(...jnxBgpM2PrefixInPrefixesAccepted.[{#PEERINDEX}],1h:now-1w)) >= {$DIFF_RATIO})
告警逻辑拆解:
- 数值门槛:最新值不为
0,且大于等于{$ACCEPT_MIN}(默认100),避免低基数场景下的小幅波动误报; - 日同比突变:最新值与"昨日同一时刻起 1 小时均值"的相对偏差 ≥
{$DIFF_RATIO}(默认0.4即 40%); - 周同比突变:最新值与"上周同一时刻起 1 小时均值"的相对偏差同样 ≥
{$DIFF_RATIO}。
只有两个时间维度的偏差同时超标才触发,极大提升了告警的鲁棒性——例如瞬时抖动或单日波动不会误报,而持续性的路由撤销/新增会触发 INFO 级别告警。该触发器设置了手动关闭(manual_close: YES),并附带 Current value: {ITEM.VALUE} 操作数据便于快速定位。
5.3 触发器依赖链建议
README 明确建议按如下顺序配置触发器依赖链(7.0 README):
PrefixesAccepted 突变 → Peer State 变化 → 设备级触发器
即 PrefixesAccepted 突变触发器依赖于邻居状态触发器,而邻居状态触发器进一步依赖于 Juniper 设备级模板中的基础可用性触发器,例如:
- High ICMP ping loss(ICMP 丢包率高)
- High ICMP ping response time(ICMP 响应时间长)
- Unavailable by ICMP ping(ICMP ping 不可达)
- No SNMP data collection(无 SNMP 数据采集)
依赖链的收益在于:当整台设备因断电、链路中断导致 SNMP 不可达时,只有最底层的设备级触发器报警,上层数百条 BGP 前缀突变告警被自动抑制,避免告警风暴。仓库中同目录的 template_juniper_total 与 template_juniper_ex_series 即提供了基于 ICMP 与 SNMP 的 Juniper 设备级可用性监控项,可作为依赖链的底层载体。
六、宏(Macros)与默认值
模板定义了三个用户宏,全部可在主机或模板级别覆盖:
| 宏 | 默认值 | 作用 |
|---|---|---|
{$DIFF_RATIO} |
0.4 |
定义 PrefixesAccepted 的变化比率阈值,0.4 即 40% |
{$ACCEPT_MIN} |
100 |
定义 PrefixesAccepted 计数的最小触发值(低于该值不告警) |
{$IGNORE_ASN} |
^6[45]* |
定义需要忽略的 ASN 范围或单个 ASN(正则) |
默认值均可在 模板定义文件的 macros 段 中核实。
值得特别说明 {$IGNORE_ASN} 的默认值 ^6[45]*:它匹配以 6 开头、后续为任意个 4 或 5 的 ASN 字符串,用于在发现阶段过滤掉符合该模式的自治系统号。实际使用时建议按自身网络拓扑将其改为具体的 ASN 列表或范围,例如 ^64512$|^65000$。
七、部署、排错与生产建议
7.1 导入模板
- 进入 Zabbix 前端:数据采集 → 模板 → 导入;
- 选择仓库中的 7.0 模板 YAML(或按需选择 6.0 版本);
- 将模板链接到目标 Juniper 主机;
- 确认主机的 SNMP 接口(community string、端口、版本)配置正确。
7.2 常见错误:snmp_parse_oid()
README 特别提示了测试阶段可能遇到的 Zabbix 报错 snmp_parse_oid()(7.0 README)。该问题源于 Juniper 的私有 MIB 文件 mib-jnx-bgpmib2.txt 中的 OID 名称与 jnxBgpM2 系列 OID 冲突或解析异常,两种解决方案任选其一:
- 在
/etc/snmp/snmp.conf中添加禁用指令,取消对BGP4-V2-MIB-JUNIPER的解析:
mibs -BGP4-V2-MIB-JUNIPER
- 或者将
mib-jnx-bgpmib2.txt从 SNMP MIB 搜索路径目录中移出,使 Zabbix/Net-SNMP 不再加载该文件。
7.3 上线前建议
- 务必先在测试环境验证并充分利用 LLD 过滤器,确认发现的邻居集合符合预期后再部署到生产(7.0 README);
- 可先用
{#PEEREMOTEADDR}过滤个别对端做灰度验证,再逐步放开; - 按 5.3 节配置完整依赖链,降低告警风暴风险;
- 结合
PrefixesReceived与PrefixesAccepted的差值,评估入方向策略过滤对路由表规模的影响。
7.4 兼容性说明
按 README 的实测结论(7.0 README):
- 已在 Juniper MX 系列(MX960、MX480、MX240 等)上测试通过;
- QFX5100 系列同样适用;
- 兼容 Junos 12 至 20 版本。
八、6.0 与 7.0 版本差异
对比两份模板文件可见,6.0 与 7.0 的发现规则、监控项、触发器、宏、值映射与预处理脚本完全一致,核心差异仅在于:
- 导出格式:6.0 版使用
groups顶层字段(Zabbix 6.0 格式),7.0 版改用template_groups字段(Zabbix 7.0 格式); - UUDI:各对象(模板组、发现规则、监控项、触发器、图形)的 UUID 不同;
- 元信息:7.0 版在模板描述中补充了作者信息与原始仓库地址。
因此,如果你运行的是 Zabbix 5.4/6.x,可直接使用 6.0 版模板;若运行 Zabbix 7.0+,则优先选择 7.0 版模板。
九、总结
template_juniper_bgp_stats_by_snmp 是一个结构清晰、生产可用的 Juniper BGP 邻居监控模板:通过单条 SNMP-LLD 发现规则自动枚举邻居,借助 JavaScript 预处理优雅解决 IPv4/IPv6 地址的十六进制解码问题,并以"日/周双维度同比突变"触发器实现对前缀接受量异常波动的稳健检测。结合 README 中的依赖链建议与 snmp_parse_oid() 排错方案,即可快速落地到 MX/QFX 系列设备的日常运维监控中。