设备路由表条目数

获取交换的交换机路由表数目。

采集侧

采集原理

采集器通过周期性地登录设备执行命令，然后解析返回，提取出路由表条目数。

小技巧

为避免开发工作量比较大，目前只需要实现思科Nexus、H3C、Huawei几个品牌的抓取即可。

注意

路由表处理比较复杂。由几部分组成：IPv6单播路由表（包括不同VRF）， IPv4单播路由表（包括不同VRF）。因为有的设备不支持一条命令查询所有VRF实例的路由表数目，要分多次查询，动态查询。另外，同一个厂商的交换机和补油漆、升职不同软件版本命令都不一样。

采集任务参数配置要求

采集方式

SSH模拟登陆

执行的命令

见下方不同厂商型号设备查询方式和返回

返回值

见下方不同厂商型号设备查询方式和返回

采集超时时间

默认20000ms

采集周期

次/30min

配置筛选条件

  1. 业务线

  2. 区域(地域)

  3. 机房

  4. POD

  5. 业务属性（服务角色）

  6. 设备角色

  7. 设备类型（路由器或者交换机等）

  8. 设备IP、IP地址段

特殊要求

  1. 使用同一机房的采集去采集该机房的路由表数目，如果该机房没有采集器，使用一组指定的默认采集器去采集

  2. 支持手动指定某一些IP地址（ip地址段）使用特定的采集器

任务筛选条件的互斥关系

  1. 设备类型必选(需要CMDB支持，也可以根据CMDB type字段是否包含router或者switch区分)

  2. 机房–POD–设备IP，存在父子关系，当父节点未被选中或者是多选状态下，子节点不能继续选择；当且仅当机房、POD、同时处于单选状态下方可继续选择设备IP；

  3. 区域–机房，存在父子关系，当父节点未被选中或者是多选状态下，子节点不能继续选择；

  4. 设备IP地址仅仅可以在没有任何其他项勾选的情况下，才可以支持手工输入多个IP地址，或者多个地址段；

不同厂商型号设备查询方式和返回

H3C

交换机

执行命令：

  1. display ip vpn-instance （查询VRF实例）

  2. display ip routing-table statistics | in Total （查询默认ipv4 VRF实例）

  3. display ip routing-table vpn-instance {VRF实例} statistics | in Total （查询已经配置的ipv4 VRF实例路由条目数）

  4. display ipv6 routing-table statistics | in Total （查询默认ipv6 VRF实例路由条目数）

  5. display ipv6 routing-table vpn-instance {VRF实例} statistics | in Total （查询已经配置的ipv6 VRF实例路由条目数）

命令返回：

<SW_NAME>display ip vpn-instance
  Total VPN-Instances configured : 5
  VPN-Instance Name               RD                     Create time
  {VRF实例}                                              2017/08/16 09:48:23
  {VRF实例}                                              2017/08/16 09:48:23
  {VRF实例}                                              2017/08/16 09:48:23
  {VRF实例}                                              2017/08/16 09:48:23
  {VRF实例}                                              2017/08/16 09:48:23

<SW_NAME>display ip routing-table statistics | in Total
Total prefixes: 2899    Active prefixes: 2899
Total      {路由总条目数}       9601        975786      964027

<SW_NAME>display ipv6 routing-table statistics | in Total
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0

<SW_NAME>display ipv6 routing-table vpn-instance CT-MJQ-360 statistics | in Total
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0

采集流程：

  1. 先查询VRF实例, 解析出实例名，供后续查询使用

  2. 查询IPv4 默认VRF实例路由条目总数

  3. 依次查询IPv4 其他VRF实例路由条目总数

  4. 查询IPv6 默认VRF实例路由条目总数

  5. 依次查询IPv6 其他VRF实例路由条目总数

  6. 将上述ipv4和ipv6所有总数目分别相加得到ipv6和ipv4的总路由条目

路由器

执行命令：

  1. display ip routing-table statistics | in Total （查询默认ipv4 VRF实例路由条目数）

  2. display ip routing-table all-vpn-instance statistics | in Total （查询其他所有ipv4 VRF实例路由条目数）

  3. display ipv6 routing-table statistics | in Total （查询默认ipv6 VRF实例路由条目数）

  4. display ipv6 routing-table all-vpn-instance statistics | in Total （查询其他所有ipv6 VRF实例路由条目数）

命令返回：

<SW_NAME>display ip routing-table statistics | in Total
Total prefixes: 738932  Active prefixes: 738932
Total      {路由总条目数}      739086      27666354    26927263

<SW_NAME>dis ip routing-table all-vpn-instance statistics | in Total
Total prefixes: 25386   Active prefixes: 25386
Total      {路由总条目数}       25418       196210      170792
Total prefixes: 40      Active prefixes: 40
Total      {路由总条目数}          40          62          22
Total prefixes: 13      Active prefixes: 13
Total      {路由总条目数}          13          13          0

<SW_NAME>display ipv6 routing-table statistics | in Total
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0

<SW_NAME>dis ipv6 routing-table all-vpn-instance statistics | in Total
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0
Total prefixes: 3       Active prefixes: 3
Total      {路由总条目数}           3           3           0

采集流程：

  1. 查询IPv4 默认VRF实例路由条目总数

  2. 查询IPv4 其他所有VRF实例路由条目总数

  3. 查询IPv6 默认VRF实例路由条目总数

  4. 查询IPv6 其他所有VRF实例路由条目总数

  5. 将上述ipv4和ipv6所有总数目分别相加得到ipv6和ipv4的总路由条目

Huawei

交换机路由器

执行命令：

  1. display ip routing-table statistics | in Total （查询默认ipv4 VRF实例路由条目数）

  2. display ip routing-table all-vpn-instance statistics | in Total （查询其他所有ipv4 VRF实例路由条目数）

  3. display ipv6 routing-table statistics | in Total （查询默认ipv6 VRF实例路由条目数）

  4. display ipv6 routing-table all-vpn-instance statistics | in Total （查询所有ipv6 VRF实例路由条目数）

命令返回：

<SW_NAME>display ip routing-table statistics | in Total
Info: It will take a long time if the content you search is too much or the string you input is too long, you can press CTRL_C to break.
Summary Prefixes : 775181
Proto      total      active     added      deleted    freed
                   routes     routes     routes     routes     routes
Total      {路由总条目数}     834844     59049025   58214160   58214160

<SW_NAME>display ip routing-table all-vpn-instance statistics | in Total
Info: It will take a long time if the content you search is too much or the string you input is too long, you can press CTRL_C to break.
Summary Prefixes : 55377
Proto      total      active     added      deleted    freed
                   routes     routes     routes     routes     routes
Total      {路由总条目数}      75250      3743665    3668415    3668415

<SW_NAME>display ipv6 routing-table statistics | in Total
Info: It will take a long time if the content you search is too much or the string you input is too long, you can press CTRL_C to break.
Summary Prefixes : 79560
Protocol   route       active      added       deleted     freed
Total      {路由总条目数}       84848       2213116     2128262     2128262

<SW_NAME>display ipv6 routing-table all-vpn-instance statistics | in Total
Info: It will take a long time if the content you search is too much or the string you input is too long, you can press CTRL_C to break.
Summary Prefixes : 0
Protocol   route       active      added       deleted     freed
Total      {路由总条目数}          0           0           0           0

采集流程：

  1. 查询IPv4 默认VRF实例路由条目总数

  2. 查询IPv4 其他所有VRF实例路由条目总数

  3. 查询IPv6 默认VRF实例路由条目总数

  4. 查询IPv6 其他所有VRF实例路由条目总数

  5. 将上述ipv4和ipv6所有总数目分别相加得到ipv6和ipv4的总路由条目

Cisco NEXUS

交换机

执行命令：

  1. show ip route summary vrf all | in Total （查询所有ipv4 VRF实例路由条目数）

  2. show ipv6 route summary vrf all | in Total （查询所有ipv6 VRF实例路由条目数）

命令返回：

SW_NAME# show ip route summary vrf all | in Total
Total number of routes: {路由总条目数}
Total number of paths:  12948

SW_NAME# show ipv6 route summary vrf all | in Total
Total number of routes: {路由总条目数}
Total number of paths:  3
Total number of multicast paths:  0

采集流程：

  1. 查询IPv4 所有VRF实例路由条目总数

  2. 查询IPv6 所有VRF实例路由条目总数

  3. 将上述ipv4和ipv6所有总数目分别相加得到ipv6和ipv4的总路由条目

Cisco Catalyst

警告

暂不实现

RuiJie

警告

暂不实现

Juniper

警告

暂不实现

采集值预处理

采集会有二类情形，一是ssh登录设备超时，没有取回结果；二是登录成功且获取回数据。

  1. 如果ssh登录设备超时，则本次采集为空，即这个时刻没有采集数据，不做任何数据的补充，不能标记为0值等；

  2. 解析返回值，取出返回值中的 总路由条目 ，记为 \(C_{used}\)

  3. 从CMDB中获取对应设备的路由表可用总数目，记为 \(C_{total}\)

  4. 计算出路由表量使用率， 即 \(C_{used} \over C_{total}\)

数据染色

对每条采集数据，染色如下。

  1. 时间戳（采集时间）

  2. 业务线

  3. 区域(地域)

  4. 机房

  5. POD

  6. 房间

  7. 机柜

  8. 业务属性（服务角色）

  9. 设备角色

  10. 带内管理IP

  11. 带外管理IP

  12. 设备名

  13. 厂商

  14. 设备品牌

  15. 设备型号

  16. 设备流程状态

  17. 路由表量使用率

  18. 路由总条目

  19. 路由表可用总数目

数据分析和报警

策略配置

策略名

  1. 报警策略名字

策略筛选条件

  1. 业务线

  2. 区域(地域)

  3. 机房

  4. POD

  5. 业务属性（服务角色）

  6. 设备角色

  7. 设备IP、IP地址段

策略生效时间

支持到小时级别（0-23）

触发阈值

使用率>=N%（N为整数）。

恢复阈值

使用率小于M%（M为整数）,默认M=N

策略生效状态

默认为策略生效状态，开启时源数据进入告警分析模块进行计算和比对，禁用时源数据不进行告警分析

策略告警等级

用于标识该策略的告警重要性程度，分5个等级：A1严重，A3主要，A5次要，A7一般，A9通知

告警组和通知方式

  1. 告警组，将不同人员分成不同的组，按组的方式发送告警；

  2. 通知方式：邮件、咚咚、微信、短信、电话；针对每个组可多选或者不选；

策略筛选条件的互斥关系

  1. IP地址类型是必选项；其他都需要支持多选；但在有父子关系情况下，如果父节点被多选，子节点不能继续被多选。

  2. 机房–POD–设备IP，存在父子关系，当父节点未被选中或者是多选状态下，子节点不能继续选择；当且仅当机房、POD同时处于单选状态下方可继续选择设备IP；

  3. 区域–机房，存在父子关系，当父节点未被选中或者是多选状态下，子节点不能继续选择；

  4. 设备IP地址仅仅可以在没有任何其他项勾选的情况下，才可以支持手工输入多个IP地址，或者多个地址段；

报警信息格式

报警信息分为两种，一种是触发阈值告警，一种是满足恢复阈值告警。我们把它称之为告警状态，分为 告警 恢复 。因为告警通道的的不通，为了便于阅读。需要针对不同渠道的报警设置信息格式。

邮件：
-----------------------
标题：【告警通知时间/恢复通知时间】【告警状态（告警/恢复）】【告警等级】【告警策略名】【机房，POD，角色，设备IP，路由表使用率】
邮件内容：
故障开始时间, 故障持续时间，故障恢复时间（当且仅当告警状态为“恢复”时候才有该时间），
业务线，区域，机房，POD，业务属性，设备角色, 设备IP，设备名称
当前路由表使用率，当前路由表条目数， 路由表可用总数目


短信，咚咚，电话，微信：
------------------------
【告警通知时间/恢复通知时间】【告警状态（告警/恢复）】【告警状态（告警/恢复）】【告警等级】【告警策略名】
【机房，POD，角色，设备IP，设备名称】【当前路由表使用率，当前路由表条目数, 路由表可用总数目】
【故障开始时间, 故障持续时间，故障恢复时间（当且仅当告警状态为“恢复”时候才有该时间）】

报警的默认收敛规则

对重复的报警信息，实行收敛。

  1. 即一条策略被触发后，发送报警通知。同时更新一些计数器。

  2. 如果在未满足恢复阈值前提条件下，再次触发了阈值，则该次触发的报警被抑制，不对外发送报警信息。但会涉及一些计数器的更新。

  3. 当满足恢复阈值时候，发送告警恢复信息。同时更新一些计数器。

  4. 之后，如报警阈值被再次满足，则对外发送新的报警通知。

关于报警时间的规则

整个策略匹配过程及报警过程中，分别涉及多个时间，做如下说明。

1.故障开始时间：第一次触发阈值（满足告警阈值的第一个点的时间） 2.故障触发告警时间：满足告警频次达到告警条件 3.告警通知时间：告警平台对外发送告警通知的时间 4.聚合告警通知时间：故障触发告警时间满足告警聚合周期，多条告警聚合后的由告警平台发出的告警通知时间（仅仅在有聚合报警策略的情况下），有4没有3。 –以下仅针对有恢复的策略– 5.故障持续时间：未恢复的告警，从故障开始时间计算到当前时间点的时间段，在告警实时看板中展示；恢复的告警，故障持续时长=故障恢复时间-故障开 始时间； 6.故障恢复时间：第一个满足恢复条件的时间，通常只有在触发了第7个“故障触发恢复条件时间”时才会被记录 7.故障触发恢复条件时间：满足恢复阈值和频次达到恢复条件 8.恢复通知时间：告警平台发送恢复通知的时间 9.聚合恢复通知时间：故障触发恢复时间满足恢复聚合周期，告警平台发出的恢复通知时间（仅仅在有聚合报警策略的情况下），有9没有8

和NOC工单系统的联动

对于产生的故障告警，需要推送给NOC工单进入工单管理。需要根据工单返回结果对该告警做一个标记，表示目前关于此告警的工单的处理情况。

处理规则：

  1. 对于产生的告警（而非进行聚合后的告警，即聚合前的单条告警。），需要推送给NOC工单平台，根据noc平台的返回信息对该条告警设置一个 工单状态标记 。

  2. 当NOC工单对该单条告警改变了状态，需要同步的跟新报警系统中该条报警的 工单状态标记 ；

  3. 当NOC工单标记为“已完成”，则触发告警恢复，忽略掉恢复阈值的检测，对外发送告警恢复信息；同时这条告警彻底清除，即便真实情况下告警并未恢复。

  4. 如果告警恢复阈值检测到满足，则触发告警恢复信息，同时通知NOC工单平台修改该工单状态为”已完成”, 关闭工单。

故障池（故障看板）的联动

但每条告警产生的时候，将该告警加入一个告警池。在告警池中对该条告警的状态进行跟踪。包括三个方面的状态跟踪。 故障持续时间，24小时内触发次数，NOC工单状态，故障恢复与否。

故障持续时间：当前时间-故障开始时间。 24小时内触发次数：最近一天满足触发阈值的次数-1。 NOC工单状态：NOC工单的状态信息。 故障恢复与否：但手工对NOC工单关闭或者自动触发恢复时候，从故障池子清除条目。不在故障池子里则认为恢复。

告警池字段要求如下：

  1. 故障开始时间

  2. 故障持续时间

  3. 设备IP

  4. 路由表使用条目

  5. 路由表使用率

  6. 设备角色

  7. 业务线

  8. 机房

  9. 历史告警数（24H）

  10. NOC工单状态

NOC工单状态说明

NOC返回状态值

状态

说明

1

新工单

告警事件生成工单的初始状态

10

待处理

NOC人员接单后触发这个状态

20

处理中

NOC人员进行处理操作

21

已转派

NOC人员处理不了转派给网络运维

99

已取消

NOC人员进行取消操作

100

已完成

NOC人员进行跟进确认后触发该状态

101

自动恢复

这个是根据告警这边的恢复通知生成

可视化

针对单台设备，对一段时间内的设备路由表使用率做可视化。要求如下。

  1. 以横坐标为时间轴，纵坐标为使用率/路由表使用条目数。刻画设备路由表使用率及使用量。每个采集时刻一个数据点。

  2. 展示设备的总路由表条目数，以红线等方式绘图于坐标图中；

  3. 默认展示一个小时的使用率信息；

未完成的部分

  1. 尚未开始