目  录

1 NetStream

1.1 NetStream配置命令

1.1.1 display interface net-stream

1.1.2 display ip netstream cache

1.1.3 display ip netstream export

1.1.4 display ip netstream template

1.1.5 enable

1.1.6 ip netstream

1.1.7 ip netstream aggregation

1.1.8 ip netstream aggregation advanced

1.1.9 ip netstream export host

1.1.10 ip netstream export rate

1.1.11 ip netstream export source

1.1.12 ip netstream export v9-template refresh-rate packet

1.1.13 ip netstream export v9-template refresh-rate time

1.1.14 ip netstream export version

1.1.15 ip netstream max-entry

1.1.16 ip netstream mirror-to

1.1.17 ip netstream mpls

1.1.18 ip netstream sampler

1.1.19 ip netstream timeout active

1.1.20 ip netstream timeout inactive

1.1.21 mirror-to interface

1.1.22 reset ip netstream statistics

 

1 NetStream

 

1.1  NetStream配置命令

1.1.1  display interface net-stream

【命令】

display interface net-stream [ netstream-number ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

netstream-number：显示指定槽位号的NetStream信息。netstream-number指定接口的接口编号。

brief：显示接口的概要信息。不指定该参数时，将显示接口的详细信息。

down：显示当前状态为down的接口的信息以及down的原因。不指定该参数时，将不会根据接口状态来过滤显示信息。

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display interface net-stream命令用来查看指定槽位号的NetStream信息。

【举例】

# 查看指定槽位号的NetStream信息。

<Sysname> display interface net-stream 3/0/1

NetStream3/0/1 current state: UP

Line protocol current state: DOWN

Description: NetStream3/0/1 Interface

Internet protocol processing : disabled

State: V4 1  V6 1  MPLS 0   

NS input packet of each VCPU: 

           0           0           0           0

           0           0           0           0

           0           0           0           0

           0           0           0           0

NS input  packet count: total 0  error 0     

1.1.2  display ip netstream cache

【命令】

display ip netstream cache [ verbose ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

verbose：显示NetStream流缓冲区的详细信息。

slot slot-number：显示指定槽位号的NetStream流缓冲区信息。slot-number表示单板的槽位号。

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display ip netstream cache命令用来查看NetStream流缓冲区信息。

【举例】

# 查看NetStream流缓冲区信息。

<Sysname> dis ip netstream cache verbose sl 6                                       

IP netstream cache information:                                                

  Stream active timeout (in minutes)  : 30                                      

  Stream inactive timeout (in seconds): 30                                     

  Stream max entry number             : 409600                                 

    IP active stream entry number     : 1                                       

  MPLS active stream entry number     : 0                                      

    L2 active stream entry number     : 0                                      

  IPL2 active stream entry number     : 1                                      

    IP stream entry been counted      : 0                                      

  MPLS stream entry been counted      : 0                                      

    L2 stream entry been counted      : 0                                      

  IPL2 stream entry been counted      : 0                                      

  Last statistics reset time          : 06/28/2012, 14:01:57                   

                                                                               

IP packet size distribution (2899392 total packets):                           

 1-32   64   96  128  160  192  224  256  288  320  352  384  416  448  480    

 .000 .000 .000 .146 .247 .248 .249 .108 .000 .000 .000 .000 .000 .000 .000    

                                                                                

  512  544  576 1024 1536 2048 2560 3072 3584 4096 4608 >4608                  

 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000                   

                                                                                

 Protocol          Total   Packets   Stream  Packets Active(sec) Idle(sec)     

                 Streams      /Sec     /Sec  /stream   /stream    /stream      

---------------------------------------------------------------------------    

                                                                               

Type DstIP(Port)            SrcIP(Port)            Pro ToS If(Direct)  Pkts    

     DstMAC(VLAN)           SrcMAC(VLAN)                                        

     TopLblType(IP/MASK)    Lbl-Exp-S-List                                     

---------------------------------------------------------------------------    

IP   13.1.1.2(0)            9.1.1.20(0)            253 0   Vlan2000(I) 388337  

     TcpFlag:       0                                                          

     DstMask:      24       SrcMask:      24       Nexthop:          10.1.1.2  

     DstAS:         0       SrcAS:         0       BgpNexthop:        0.0.0.0  

     OutVRF:        0       InVRF:        14                                   

     SamplerMode:   0       SamplerInt:    0                                   

     Active:       10       Bytes/Pkt:   174                                   

IP&  13.1.1.2(0)            9.1.1.20(0)            253 0   GE6/0/26(I) 2513355 

L2   0000-0000-0000(0)      0000-0000-0000(2000)                               

     TcpFlag:       0                                                          

     DstMask:       0       SrcMask:       0       Nexthop:           0.0.0.0  

     DstAS:         0       SrcAS:         0       BgpNexthop:        0.0.0.0  

     OutVRF:        0       InVRF:         0                                   

     SamplerMode:   0       SamplerInt:    0                                   

     Active:       60       Bytes/Pkt:   174       

表1-1 display ip netstream cache命令显示信息描述表

字段	描述
IP netstream cache information	NetStream流缓冲区信息
Stream active timeout (minutes)	活跃的流在超时后的老化时间（以分钟为单位）
Stream inactive timeout (seconds)	不活跃的流在超时后的老化时间（以秒为单位）
Stream max entry number	NetStream流缓冲区中允许的最大流数
IP Active stream entry number	NetStream流缓冲区中活跃的IP流数
MPLS Active stream entry number	NetStream流缓冲区中活跃的MPLS流数
L2 active stream entry number	NetStream流缓存区中活跃的二层流数
IPL2 active stream entry number	NetStream流缓冲区中活跃的二三层混合流数
IP Stream entry been counted	被统计的IP流数
L2 stream entry been counted	被统计的二层流数
MPLS Stream entry been counted	被统计的MPLS流数
IPL2 stream entry been counted	被统计的二三层混合流数
Last statistics reset time	上次清除统计的时间，此时间为清除时刻的绝对时间，它不会随系统时间的修改而变化 该字段只在执行了reset ip netstream statistics命令后才会出现，否则显示： Last statistics reset time  : Never
IP packet size distribution (1103746 total packets):	IP报文按大小分布情况，括号中为IP报文总数。 分布值按占IP报文总数的比率显示，只显示3位小数，如“.027”表示占IP报文总数的0.027
1-32   64   96  128  160  192  224  256  288  320  352  384  416  448  480 512  544  576 1024 1536 2048 2560 3072 3584 4096 4608 >4608	报文尺寸区间（统计IP报文时，不统计二层链路层的头；统计MPLS报文时，统计二层链路层的头）。长度不超过576字节时，以32字节为单位递增，例如：“1-32”是长度为1～32个字节的报文数目，“64”是长度为33～64字节的报文数。长度超过1024字节时，以512字节为单位递增，例如“1536”是长度为1025～1536字节的报文数。长度在577～1024间的报文记录在1024项中
Protocol     Total Streams     Packets /Sec Stream/Sec   Packets/stream   Active(sec)/stream     Idle(sec)/stream	按协议分类的报文统计信息：协议类型、总流数、每秒的报文数、每秒的流数、平均每条流的报文数、平均每条流的活跃时间、平均每条流的非活跃时间
Type DstIP(Port)            SrcIP(Port)            Pro ToS If(Direc)  Pkts	当前流缓冲区中活跃流的IP层信息：流的类型、目的IP地址（目的端口号）、源IP地址（源端口号）、协议号、ToS、接口名（方向）、包数 其中流的类型有五种：IP流（IP）、二层流（L2）、二三层混合流（IP&L2）、不带IP选项的MPLS流（MPLS)、带IP选项的MPLS流（IP&MPLS） 需要注意的是，对于ICMP报文只有Type和Code字段，因此用目的端口号的高8位表示Type字段、低8位表示Code字段，源端口号为0
DstMAC(VLAN)          SrcMAC(VLAN)	当前流缓冲区中活跃流的二层信息：目的MAC地址、目的VLAN ID、源MAC地址、源VLAN ID
TopLblType(IP/MASK)      Lbl-Exp-S-List	当前流缓冲区中活跃流的MPLS信息：栈顶标签的类型（栈顶标签对应的IP地址及掩码长度）、标签列表 标签主要的三部分：20比特的Label字段表示标签值，3比特的EXP字段用来实现QoS，1比特S字段置1表示已达栈底 标签列表中至多列出三层标签
TcpFlag: DstMask:      SrcMask:             Nexthop:      DstAS:           SrcAS:            BgpNexthop:   OutVRF:       InVRF:                                 SamplerMode:                     SamplerInt:  Active:       Bytes/Pkt:	当前流缓冲区中活跃流的其它信息：TCP标记、目的掩码、源掩码、路由下一跳、目的自治系统、源自治系统、BGP下一跳、出方向报文所属VPN 、入方向报文所属VPN、采样模式（F/D/R）、采样间隔、流活跃时间、平均每个包的字节数 NetStream采样模式，目前支持三种： ·     0不采样，统计所有报文； ·     1固定采样； ·     2随机采样（目前SPC单板不支持）
0000-0000-0000      0000-0000-0000	二层报文的MAC地址池统计，目前设备暂时不支持，显示为：0000-0000-0000

 

1.1.3  display ip netstream export

【命令】

display ip netstream export [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display ip netstream export命令用来查看NetStream统计输出报文的各种信息。

【举例】

# 查看NetStream统计输出信息。

<Sysname> display ip netstream export

IP export information:

  Stream source interface                        : GigabitEthernet3/1/8.1

  Stream destination VPN-instance                :

  Stream destination IP (UDP)                    : 1.1.1.13 (9991)

  Version 5 exported stream number               : 8

  Version 5 exported UDP datagram number (failed): 1 (0)

  Version 9 exported stream number               : 0

  Version 9 exported UDP datagram number (failed): 0 (0)

 

MPLS export information:

  Stream source interface                        : GigabitEthernet3/1/8.1

  Stream destination VPN-instance                :

  Stream destination IP (UDP)                    : 1.1.1.13 (9991)

  Version 9 exported stream number               : 0

  Version 9 exported UDP datagram number (failed): 0 (0)

 

IPL2 export information:

  Stream source interface                        : GigabitEthernet3/1/8.1

  Stream destination VPN-instance                :

  Stream destination IP (UDP)                    : 1.1.1.13 (9991)

  Version 9 exported stream number               : 0

  Version 9 exported UDP datagram number (failed): 0 (0)

 

as aggreagtion export information:

  Stream source interface                        : GigabitEthernet3/1/8

  Stream destination VPN-instance                :

  Stream destination IP (UDP)                    : 1.1.1.13 (9991)

  Version 8 exported stream number               : 3

  Version 8 exported UDP datagram number (failed): 2 (0)

  Version 9 exported stream number               : 0

  Version 9 exported UDP datagram number (failed): 0 (0)     

表1-2 display ip netstream export命令显示信息描述表

字段	描述
IP export information	版本5和版本9统计输出信息
Stream source interface	输出信息的源接口
Stream destination vpn-instance	输出信息的目的地址所在的VPN
Stream destination IP (UDP)	输出信息的目的地址和目的（UDP）端口号
Version 5 exported stream number	使用版本5格式发送的流信息数
Version 5 exported UDP datagram number (failed)	使用版本5格式发送的UDP报文数（发送失败的报文数）
Version 9 exported stream number	使用版本9格式发送的流信息数
Version 9 exported UDP datagram number (failed)	使用版本9格式发送的UDP报文数（发送失败的报文数）
MPLS export information	版本9 MPLS流统计输出信息
IPL2 export information	二三层混合流统计输出信息
根据不同的聚合方式，下面的显示信息会有差异，请以实际配置的聚合方式为准，这里以“自治系统”聚合方式为例
AS aggregation export information	启用自治系统聚合的版本8统计输出信息。没有启用的聚合功能不显示（各项信息同上）
Version 8 exported stream number	使用版本8格式发送的流信息数
Version 8 exported UDP datagram number (failed)	使用版本8格式发送的UDP报文数（发送失败数）

 

1.1.4  display ip netstream template

【命令】

display ip netstream template [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

slot slot-number：显示指定槽位号的模板信息。slot-number表示单板的槽位号。如果不指定该参数，则显示模板的配置信息。

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display ip netstream template命令用来查看NetStream模板的配置和状态信息。

·     如果指定槽位号，则只输出该接口板上的模板配置信息和状态信息；

·     如果不指定槽位号，则只输出模板的配置信息。

【举例】

# 使能自治系统聚合。查看NetStream模板信息。

<Sysname> display ip netstream template

 Stream template refresh-rate packet          : 20

 Stream template refresh-rate time(in minute) : 30

 Active stream templates                      : 2

 Added stream templates                       : 2

as outbound template:

 Template ID                : 3258

 Packets                    : 0

 Last template export time  : Never

 Field count                : 14

 Field type                   Field length (byte)

---------------------------------------------------------------------------

 Flows                        4

 Out packets                  8

 Out bytes                    8

 First switched               4

 Last switched                4

 Source AS                    4

 Destination AS               4

 Input SNMP                   4

 Output SNMP                  4

 Direction                    1

 Sampling algorithm           1

 PAD                          1

 PAD                          1

 Sampling interval            4

as inbound template:

 Template ID                : 3257

 Packets                    : 0

 Last template export time  : Never

 Field count                : 14

 Field type                   Field length (byte)

---------------------------------------------------------------------------

 Flows                        4

 In packets                   8

 In bytes                     8

 First switched               4

 Last switched                4

 Source AS                    4

 Destination AS               4

 Input SNMP                   4

 Output SNMP                  4

 Direction                    1

 Sampling algorithm           1

 PAD                          1

 PAD                          1

 Sampling interval            4

表1-3 display ip netstream template命令显示信息描述表

字段	描述
Stream template refresh-rate packet	模板的包刷新率
Stream template refresh-rate time(in minute)	模板的时间刷新率（以分钟为单位）
Active stream templates	当前活跃的模板数
Added stream templates	创建的模板总数
根据不同的聚合方式，下面的显示信息会有差异，请以实际配置的聚合方式为准，这里以“自治系统”聚合方式为例
AS outbound template	AS出方向模板信息
AS inbound template	AS入方向模板信息
Template ID	模板ID
Packets	使用该模板的发送报文数。由于一个报文中可能携带多条流，不同的流会使用到不同的模板，这里的Packets实际上是流数。
Last template export time	该模板最近的一次输出时间
Field count	模板的域总数
Field type	域类型
Field length (byte)	域长度，以字节为单位
Flows	聚合流数量
Out/In packets	输出/输入的数据包大小
Out/In bytes	输出/输入的数据大小，以字节为单位
First switched	记录转发第一个报文时的系统时间，单位为毫秒
Last switched	记录转发最后一个报文时的系统时间，单位为毫秒
Source AS	源AS号
Destination AS	目的AS
Input SNMP	输入接口的索引
Output SNMP	输出接口的索引
Direction	方向字段
Sampling algorithm	采样算法
PAD	空白占位符
Sampling interval	采样率

1.1.5  enable

【命令】

enable

undo enable

【视图】

NetStream聚合视图

【缺省级别】

3：管理级

【参数】

无

【描述】

enable命令用来使能当前聚合视图对应的聚合方式。undo enable命令用来禁止该聚合方式。

缺省情况下，未使能任何NetStream聚合功能。

相关配置可参考命令ip netstream aggregation。

【举例】

# 使能NetStream的自治系统聚合方式。

<Sysname> system-view

[Sysname] ip netstream aggregation as

[Sysname-ns-aggregation-as] enable

1.1.6  ip netstream

【命令】

ip netstream

undo ip netstream

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

无

【描述】

ip netstream命令用来启动NetStream统计功能。undo ip netstream命令用来关闭NetStream统计功能。

缺省情况下，未启动NetStream统计功能。

【举例】

# 启动NetStream统计功能。

<Sysname> system-view

[Sysname] ip netstream

1.1.7  ip netstream aggregation

【命令】

ip netstream aggregation { as | destination-prefix | prefix | prefix-port | protocol-port | source-prefix | tos-as | tos-bgp-nexthop | tos-destination-prefix | tos-prefix | tos-protocol-port | tos-source-prefix }

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

as：自治系统聚合，根据NetStream流的源自治系统号、目的自治系统号、输入接口索引和输出接口索引4个关键值对流分类。

destination-prefix：目的前缀聚合，根据NetStream流的目的自治系统号、目的掩码长度、目的前缀和输出接口索引4个关键值对流分类。

prefix：源和目的前缀聚合，根据NetStream流的源自治系统号、目的自治系统号、源掩码长度、目的掩码长度，源前缀、目的前缀、输入接口索引和输出接口索引8个关键值对流分类。

prefix-port：前缀端口聚合，根据NetStream流的源前缀、目的前缀、源掩码长度、目的掩码长度、ToS、协议号、源端口、目的端口、输入接口索引、输出接口索引10个关键值对流分类。

protocol-port：协议－端口聚合，根据NetStream流的协议号、源端口和目的端口3个关键值对流分类。

source-prefix：源前缀聚合，根据NetStream流的源自治系统号、源掩码长度、源前缀和输入接口索引4个关键值对流分类。

tos-as：服务类型－自治系统聚合，根据NetStream流的ToS、源自治系统号、目的自治系统号、输入接口索引和输出接口索引5个关键值对流分类。

tos-bgp-nexthop：边界网关－下一跳－服务类型聚合，根据NetStream流的ToS、BGP下一跳IP地址、输出接口索引3个关键值对流分类。边界网关－下一跳－服务类型聚合只在V9模板下生效。

tos-destination-prefix：服务类型－目的前缀聚合，根据NetStream流的ToS、目的自治系统号、目的掩码长度、目的前缀和输出接口索引5个关键值对流分类。

tos-prefix：服务类型－前缀聚合，根据NetStream流的ToS、源自治系统号、源前缀、源掩码长度、目的自治系统号、目的掩码长度、目的前缀、输入接口索引和输出接口索引9个关键值对流分类。

tos-protocol-port：服务类型－协议－端口聚合，根据NetStream流的ToS、协议号、源端口、目的端口、输入接口索引和输出接口索引6个关键值对流分类。

tos-source-prefix：服务类型－源前缀聚合，根据NetStream流的ToS、源自治系统号、源前缀、源掩码长度和输入接口索引5个关键值对流分类。

【描述】

ip netstream aggregation命令用来设置NetStream流聚合方式，并进入相应的NetStream聚合视图。在聚合视图下，可以启用或关闭聚合功能，以及设置NetStream统计输出报文源接口、目的IP地址以及目的端口号。

相关配置可参考命令enable、ip netstream export host和ip netstream export source。

【举例】

# 进入NetStream自治系统聚合视图。

<Sysname> system-view

[Sysname] ip netstream aggregation as

[Sysname-ns-aggregation-as]

1.1.8  ip netstream aggregation advanced

【命令】

ip netstream aggregation advanced

undo ip netstream aggregation advanced

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

无

【描述】

ip netstream aggregation advanced命令用来使能硬件流聚合功能。undo ip netstream aggregation advanced命令用于关闭硬件流聚合功能。

需要注意的是：

·     使能硬件流聚合时，系统根据NetStream统计功能是否配置了统计信息输出的目的地址以及配置的聚合类型来决定是否进行硬件聚合，如果在系统视图下配置了统计信息输出的目的地址，则硬件聚合配置不生效。

·     使能硬件流聚合以后，硬件聚合流表项老化到普通流表项记录中，并进行表项的输出。

相关配置可参考命令ip netstream export host和ip netstream aggregation。

 

【举例】

# 使能硬件流聚合功能。

<Sysname> system-view

[Sysname] ip netstream aggregation advanced

1.1.9  ip netstream export host

【命令】

ip netstream export host ip-address udp-port [ vpn-instance vpn-instance-name ]

undo ip netstream export host [ ip-address [ vpn-instance vpn-instance-name ] ]

【视图】

系统视图/NetStream聚合视图

【缺省级别】

3：管理级

【参数】

ip-address：NetStream统计输出报文的目的IP地址。

udp-port：NetStream统计输出报文的目的UDP端口号，取值范围为0～65535。

vpn-instance vpn-instance-name：指定NetStream统计输出报文的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示NetStream统计输出报文的目的地址位于公网中。

【描述】

ip netstream export host命令用来配置NetStream统计输出报文的目的地址和目的UDP端口号。undo ip netstream export host命令用来删除已有配置，未指定IP地址时为取消指定本视图下配置的所有IP地址。

缺省情况下，系统视图和聚合视图下均没有配置目的地址和目的UDP端口号。

需要注意的是：

·     不同聚合视图下可以配置相同的目的地址和目的UDP端口号。

·     若聚合视图下没有配置目的地址和目的UDP端口号，则使用系统视图下的配置；若聚合视图下配置了目的地址和目的UDP端口号，则使用聚合视图下的配置。

·     一个视图下最多可配置4组目的地址，包括不同VPN实例。在同一视图下，若先后配置了IP地址相同、UDP端口号不同的目的地址，则后配置的目的地址生效。特别在用户配置了不同的VPN实例名称时，允许配置相同的IP地址和UDP端口号。普通流统计输出报文会发给系统视图下配置的所有目的主机。聚合流统计输出报文会发给聚合类型对应的聚合视图下配置的所有目的主机。

·     普通流统计输出报文会发给系统视图下配置的所有目的地址。聚合流统计输出报文会发给聚合类型对应的聚合视图下配置的所有目的地址。为了减少对网络带宽的占用，可以只在聚合视图下配置ip netstream export host命令，此时设备只会输出聚合流信息。

相关配置可参考命令ip netstream aggregation和ip netstream export source。

【举例】

# 设置NetStream统计输出报文的目的IP地址为172.16.105.48，UDP端口号为5000，在vpn1中查询路由。

<Sysname> system-view

[Sysname] ip netstream export host 172.16.105.48 5000 vpn-instance vpn1

1.1.10  ip netstream export rate

【命令】

ip netstream export rate rate

undo ip netstream export rate

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

rate：NetStream统计输出报文的最大输出速度，单位为每秒允许输出最大报文个数。取值范围是1～1000。

【描述】

ip netstream export rate命令用来配置输出速率限制。undo ip netstream export rate命令用来关闭输出速率限制功能。

缺省情况下，NetStream统计输出报文的输出速率不受限制。

 

【举例】

# 设置每秒最多允许10个报文被输出。

<Sysname> system-view

[Sysname] ip netstream export rate 10

1.1.11  ip netstream export source

【命令】

ip netstream export source interface interface-type interface-number

undo ip netstream export source

【视图】

系统视图/NetStream聚合视图

【缺省级别】

3：管理级

【参数】

interface-type interface-number：NetStream统计输出报文的源接口，由接口类型和接口编号组成。

【描述】

ip netstream export source命令用来配置NetStream统计输出报文的源接口。undo ip netstream export source命令用来取消配置的输出报文的源接口。

缺省情况下，采用统计输出报文的出接口（即与服务器相连的接口）作为源接口。

·     不同聚合视图下可以配置不同的源接口。

·     聚合视图下若没有配置源接口，则使用系统视图下的配置。

·     建议使用网管口作为源接口，与服务器相连，并向服务器输出统计信息。

相关配置可参考命令ip netstream aggregation。

【举例】

# 将NetStream统计输出报文源接口设置为M-Ethernet 6/0/0。

<Sysname> system-view

[Sysname] ip netstream export source interface M-Ethernet 6/0/0

1.1.12  ip netstream export v9-template refresh-rate packet

【命令】

ip netstream export v9-template refresh-rate packet packets

undo ip netstream export v9-template refresh-rate packet

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

packets：NetStream统计输出报文版本9模板的包刷新率，单位为上报报文的个数，即每隔多少个包发送一次模板，通知NetStream服务器最新的V9模版格式。取值范围为1～600，缺省值为20。

【描述】

ip netstream export v9-template refresh-rate packet命令用来配置NetStream统计输出报文版本9模板的包刷新率。undo ip netstream export v9-template refresh-rate packet命令用来恢复缺省情况。

缺省情况下，每隔20个包设备发送一次版本9模板。

需要注意的是：

·     V9版本是基于模板方式的、可支持自定义格式，所以设备上需要定期刷新模板，并通知NetStream服务器最新的V9模版格式。用户可以根据实际情况，配置版本9模板的包刷新率，及时更新模板。

·     可以同时配置包刷新率和时间刷新率，只要满足任意一个刷新条件，设备就会将符合条件的模板发送给NetStream服务器。

相关配置可参考命令ip netstream export v9-template refresh-rate time。

【举例】

# 将NetStream统计输出报文版本9模板的包刷新率设为100。

<Sysname> system-view

[Sysname] ip netstream export v9-template refresh-rate packet 100

1.1.13  ip netstream export v9-template refresh-rate time

【命令】

ip netstream export v9-template refresh-rate time minutes

undo ip netstream export v9-template refresh-rate time

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

minutes：NetStream统计输出报文版本9模板的时间刷新率，单位为分钟，即每隔多少分钟发送一次模板，通知NetStream服务器最新的V9模版格式。取值范围为1～3600，缺省为30分钟。

【描述】

ip netstream export v9-template refresh-rate time命令用来配置NetStream统计输出报文版本9模板的时间刷新率。undo ip netstream export v9-template refresh-rate time命令用来恢复缺省情况。

缺省情况下，每隔30分钟设备发送一次版本9模板。

需要注意的是：

·     V9版本是基于模板方式的、可支持自定义格式，所以设备上需要定期刷新模板，并通知NetStream服务器最新的V9模版格式。用户可以根据实际情况，配置版本9模板的时间刷新率，及时更新模板。

·     可以同时配置包刷新率和时间刷新率，只要满足任意一个刷新条件，设备就会将符合条件的模板发送给NetStream服务器。

相关配置可参考命令ip netstream export v9-template refresh-rate packet。

【举例】

# 将NetStream统计输出报文版本9模板的时间刷新率设为60分钟。

<Sysname> system-view

[Sysname] ip netstream export v9-template refresh-rate time 60

1.1.14  ip netstream export version

【命令】

ip netstream export version 5 [ origin-as | peer-as ]

ip netstream export version 9 [ origin-as | peer-as ] [ bgp-nexthop ]

undo ip netstream export version

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

origin-as：流信息中记录的自治系统号为起始自治系统号。

peer-as：流信息中记录的自治系统号为邻接自治系统号。

bgp-nexthop：流信息中记录BGP下一跳。

【描述】

ip netstream export version 5命令用来配置NetStream版本5的AS参数。ip netstream export version 9命令用来配置NetStream版本9的AS参数和BGP下一跳选项。undo ip netstream export version命令用来恢复缺省情况。

缺省情况下，普通流信息通过版本5的NetStream统计输出报文发送，聚合流信息通过版本8的NetStream统计输出报文发送，MPLS流信息不输出。自治系统选项使用邻接自治系统号（peer-as），流信息中不记录BGP下一跳地址。

需要注意的是：

·     NetStream流信息中会记录流的源IP地址及其对应的自治系统号；目的IP地址及其对应的自治系统号。设备会根据用户实际配置的自治系统参数来确定记录的自治系统号。

·     只有在版本号为9时，才可以配置BGP下一跳。

【举例】

# 将NetStream统计输出报文版本号设为5，并采用起始自治系统号作为给定IP地址的自治系统号。

<Sysname> system-view

[Sysname] ip netstream export version 5 origin-as

1.1.15  ip netstream max-entry

【命令】

ip netstream max-entry { max-entries | aging | disable-caching }

undo ip netstream max-entry

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

max-entries：NetStream流缓冲区大小。取值范围为65536～409600。参数值在各板上单独生效，而不是各板的总和。

aging：在达到最大流表个数时，进行强制老化。

disable-caching：在达到最大流表个数时，禁止新建流。

【描述】

ip netstream max-entry命令用来配置NetStream流缓冲区大小，即所能容纳NetStream流的最大表项数量，以及当流达到流缓冲区的最大数量时，是进行强制老化，还是禁止创建新的NetStream流。undo ip netstream max-entry命令用来恢复缺省情况。

缺省情况下，流缓冲区的最大表项数目为409600，统计总表项达到最大流表数目时，进行强制老化。

【举例】

# 设置NetStream流缓冲区的大小为65536。

<Sysname> system-view

[Sysname] ip netstream max-entry 65536

# 设置NetStream在达到最大流表个数时，禁止建流。

<Sysname> system-view

[Sysname] ip netstream max-entry disable-caching

# 设置NetStream在达到最大流表个数时，进行强制老化。

<Sysname> system-view

[Sysname] ip netstream max-entry aging

1.1.16  ip netstream mirror-to

【命令】

ip netstream mirror-to interface Net-Stream interface-number [ backup-interface Net-Stream interface-number ] { inbound | outbound }

undo ip netstream mirror-to { inbound | outbound }

【视图】

接口视图

【缺省级别】

3：管理级

【参数】

Net-Stream interface-number：指定流镜像到Net-Stream接口。

backup-interface Net-Stream interface-number：指定流镜像到备用Net-Stream接口。

inbound：对入方向的流量进行镜像。

outbound：对出方向的流量进行镜像。

【描述】

ip netstream mirror-to命令用来将接口的流量镜像到Net-Stream接口，进行NetStream统计。undo ip netstream mirror-to命令用来取消对接口流量的镜像。

缺省情况下，不对接口流量进行镜像。

需要注意的是，

·     此功能仅在SPC单板上支持；

·     同一SPC单板上的接口在同一个方向（同为入方向或出方向）只能镜像到同一个Net-Stream接口，但如果在SPC单板的两个不同接口上分别配置入方向和出方向流镜像，则可镜像到两个不同的Net-Stream接口。

【举例】

# 在接口GigabitEthernet3/0/1上配置入方向流量镜像，进入方向的流量镜像到Net-stream2/0/1接口上。

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] ip netstream mirror-to interface Net-Stream2/0/1 inbound

1.1.17  ip netstream mpls

【命令】

ip netstream mpls [ label-positions label-position1 [ label-position2 [ label-position3 ] ] ] [ no-ip-fields ]

undo ip netstream mpls

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

label-positions：统计的标签位置。

no-ip-fields：不统计IP选项。

label-position1：指定统计的第一个标签位置，取值范围1～6。

label-position2：指定统计的第二个标签位置，取值范围1～6。

label-position3：指定统计的第三个标签位置，取值范围1～6。

【描述】

ip netstream mpls命令用来启动统计和输出MPLS格式的报文，通过参数no-ip-fields可设定是否带IP内容进行输出，不带任何参数时，表示使用首标签并且带有IP内容进行输出。undo ip netstream mpls用来禁用统计和输出MPLS格式的报文。

缺省情况下，禁用统计和输出MPLS格式报文。

需要注意的是：

·     只有在启用了Netstream统计功能后，配置NetStream MPLS报文统计功能才生效。

·     对于MPLS内层负载是IPv4报文时，需要启用IPv4 Netstream统计功能。

·     对于MPLS内层负载是IPv6报文时，需要启用IPv6 Netstream统计功能。

·     对于MPLS内层负载既不是IPv4报文也不是IPv6报文时，需要启用IPv4 Netstream统计功能。

·     在NAM单板上，对于MPLS内层负载是非IPv4报文的情况，需要启用IPv4 Netstream统计功能，且只能统计标签部分。

【举例】

# 启动MPLS统计，统计前三层标签，同时统计报文中的IP内容。

<Sysname> system-view

[Sysname] ip netstream mpls label-positions 1 2 3

1.1.18  ip netstream sampler

【命令】

ip netstream sampler sampler-name { inbound | outbound }

undo ip netstream sampler sampler-name { inbound | outbound }

【视图】

接口视图

【缺省级别】

3：管理级

【参数】

sampler sampler-name：采样器名称，最长32个字符。

inbound：入方向采样。

outbound：出方向采样。

【描述】

ip netstream sampler命令用来启用NetStream采样功能。undo ip netstream sampler命令用来禁用NetStream采样功能。缺省情况下，未使能采样功能。

需要注意的是，此功能仅在SPC单板上支持。

【举例】

# 使能NetStream入方向采样，使用名为abc的采样器。

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] ip netstream sampler abc inbound

1.1.19  ip netstream timeout active

【命令】

ip netstream timeout active minutes

undo ip netstream timeout active

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

minutes：活跃流的老化时间，单位为分钟。取值范围为1～60，缺省为30。

【描述】

ip netstream timeout active命令用来配置NetStream活跃流的老化时间。undo ip netstream timeout active命令用来恢复缺省情况。

缺省情况下，活跃流的老化时间为30分钟。

 

相关配置可参考命令ip netstream timeout inactive。

【举例】

# 将NetStream活跃流的老化时间设置为60分钟。

<Sysname> system-view

[Sysname] ip netstream timeout active 60

1.1.20  ip netstream timeout inactive

【命令】

ip netstream timeout inactive seconds

undo ip netstream timeout inactive

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

seconds：不活跃流的老化时间，单位为秒。取值范围为10～600，缺省为30。

【描述】

ip netstream timeout inactive命令用来配置NetStream不活跃流的老化时间。undo ip netstream timeout inactive命令用来恢复缺省情况。

缺省情况下，不活跃流的老化时间为30秒。

相关配置可参考命令ip netstream timeout active。

 

【举例】

# 将不活跃流的老化时间设置为60秒。

<Sysname> system-view

[Sysname] ip netstream timeout inactive 60

1.1.21  mirror-to interface

【命令】

mirror-to interface Net-Stream interface-number [ backup-interface Net-Stream interface-number ] sampler sampler-name

undo mirror-to interface interface-type interface-number

【视图】

流行为视图

【缺省级别】

2：系统级

【参数】

Net-Stream interface-number：镜像的主目的接口。

backup-interface Net-Stream interface-number：镜像的备份目的接口。

sampler-name：采样器名称。

【描述】

mirror-to interface命令用来将流行为中配置的流镜像到支持NetStream统计功能的单板（包括SPC单板、SPE单板、NAM单板）的Net-Stream接口上。undo mirror-to interface命令用来取消流镜像。

缺省情况下，没有配置流镜像。

【举例】

# 将流行为中配置的流镜像到Net-Stream4/0/1，备份接口为Net-Stream10/0/1。

<Sysname> system-view

[Sysname] traffic behavior ns

[Sysname-behavior-ns] mirror-to interface Net-Stream4/0/1 backup-interface Net-Stream10/0/1

1.1.22  reset ip netstream statistics

【命令】

reset ip netstream statistics

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

无

【描述】

reset ip netstream statistics命令用来将流缓冲区中所有流强制老化，并清除NetStream缓冲区的状态信息和输出报文信息。

需要注意的是：在NAM单板上使用NetStream功能时，在执行reset ip netstream statistics命令时，可能要持续几分钟，在这段时间内不能统计。

【举例】

# 将流缓冲区中所有流老化，并清除NetStream缓冲区的状态信息和输出报文信息。

<Sysname> reset ip netstream statistics

This process may take a few minutes.

Netstream statistic function is disabled during this process.