首页/网络/BGP 与广域网速查/邻居描述(description)的运维价值
BGP 基础与邻居89 条

邻居描述(description)的运维价值

给每个邻居写清晰描述(运营商名、链路编号、联系人):排障与审计时不用翻台账,降低误操作风险。

BGP 与广域网速查网络更新于 2026-10-13

一行文字值多少

description 是邻居配置里的一行文字,作用是把邻居的身份固化进配置:对端名称、运营商、链路编号、机房、带宽与工单号。它不参与协议行为、不影响选路,但在排障与审计时价值极高——多设备、多邻居的环境下,描述能把「10.0.0.2 是哪个」这个问题从翻台账变成看一眼配置,也直接降低割接时删错邻居的概率。

基本信息

内容建议对端名称、AS 号、机房/链路编号、带宽与用途
常见格式对端-机房-带宽-时间或工单号
协议影响无,不参与报文交互与选路计算
实际作用show 输出即是台账,割接与审计更直观
联动要求与监控告警信息对齐,便于定位与通知
维护要求链路割接后同步更新,避免描述与现状脱节

典型使用场景

  • 多运营商出口:一眼看出哪个邻居属于哪家、承载什么业务
  • 割接与审计:修改或删除邻居前先看描述,降低误操作风险
  • 交接与轮岗:描述即文档的一部分,降低对个人记忆的依赖
  • 监控联动:告警信息带描述,值班人员不用再查台账
  • 现网盘点:用描述快速对应链路资源与合同关系

配置与查看

配置与查看
router bgp 65001
 neighbor 10.0.0.2 description ChinaNet-BJ-10G-2024Q3   # 对端-机房-带宽-时间
 neighbor 10.0.0.6 description CNCMobile-SH-1G-Backup   # 标明备份关系
!
show ip bgp neighbors 10.0.0.2      # 明细里能看到 Description 字段
show ip bgp summary                 # 概览状态与 AS 号,与描述对照核对

描述字段内容建议

字段示例作用
对端名称或运营商ChinaNet快速判断归属与责任方
机房与链路编号BJ-M1-10G对应物理资源与端口
带宽与主备关系10G-主用判断容量与备份关系
时间或工单号2024Q3-INC12345追溯变更来源与时间点
描述是零成本的知识固化:写「10.0.0.2」不如写清是哪家的哪条线。接手的人不用问人就能判断这条邻居能不能动、动了会影响谁。
命名规范要统一,否则描述会退化成个人备注。建议在规范里固定字段顺序,并把描述同步到监控与台账系统,避免两处信息各说各话。

易错点

  • 描述留空或用默认值:大规模网络的排障全靠记忆与个人经验,交接成本极高,误操作概率也上升
  • 描述与实际脱节:链路割接后未更新,反而误导判断,需要把描述更新写进变更流程
  • 描述信息含糊:只写「备用」无法判断是谁的备用、备的是哪条主链路,应包含对端与主备关系
  • 只在一处维护:设备描述与台账、监控不一致时,以哪个为准会引发争议,应指定唯一来源

数据来源与参考

  • 运维规范实践
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌