Login
- Table of Contents
-
- 12-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System Maintenance and Debugging Commands
- 02-NQA Commands
- 03-NTP Commands
- 04-Clock Monitoring Commands
- 05-IPC Commands
- 06-SNMP Commands
- 07-RMON Commands
- 08-Sampler Commands
- 09-Mirroring Commands
- 10-NetStream Commands
- 11-IPv6 NetStream Commands
- 12-Protocol Packet Statistics Commands
- 13-Information Center Commands
- 14-Flow Logging Commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 10-NetStream Commands | 173.67 KB |
Contents
NetStream configuration commands
ip netstream aggregation advanced
ip netstream export v9-template refresh-rate packet
ip netstream export v9-template refresh-rate time
NetStream configuration commands
|
|
NOTE: In this documentation, SPC cards refer to the interface cards prefixed with SPC, for example, SPC-GT48L. SPE cards refer to the cards prefixed with SPE, for example, SPE-1020-E-II. NAM cards refer to the cards prefixed with IM-NAM, for example, IM-NAM-II. |
display interface netstream
Syntax
display interface netstream netstream-number [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
netstream netstream-number: Displays the NetStream entry information of a card. The netstream-number argument specifies a card by its slot number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display interface netstream to display the NetStream entry information of a card.
Examples
# Display the NetStream entry information of a card.
<Sysname> display interface netstream 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
display ip netstream cache
Syntax
display ip netstream cache [ verbose ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
verbose: Displays detailed information about the NetStream entries in the cache.
slot slot-number: Displays the NetStream entry information in the cache of a card. The slot-number argument specifies a card by its slot number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display ip netstream cache to display the NetStream entry information in the cache.
Examples
# Display information about the NetStream entries in the cache.
<Sysname> display ip netstream cache verbose slot 13
IP netstream cache information:
Stream active timeout (in minutes) : 30
Stream inactive timeout (in seconds): 30
Stream max entry number : 307200
IP active stream entry number : 8
MPLS active stream entry number : 0
IPL2 active stream entry number : 1
IP stream entry been counted : 8
MPLS stream entry been counted : 0
IPL2 stream entry been counted : 1
Last statistics reset time : 04/21/2008, 16:23:21
IP packet size distribution (3709294 total packets):
1-32 64 96 128 160 192 224 256 288 320 352 384 416 448 480
.000 .001 .008 .724 .008 .008 .008 .008 .008 .008 .008 .008 .008 .009 .008
512 544 576 1024 1536 2048 2560 3072 3584 4096 4608 >4608
.008 .008 .008 .112 .028 .000 .000 .000 .000 .000 .000 .000
Protocol Total Packets Stream Packets Active(sec) Idle(sec)
Streams /Sec /Sec /stream /stream /stream
---------------------------------------------------------------------------
IP-other 3 3206 0 294980 2 32
UDP-other 4 4275 0 294980 2 32
ICMP 2 2137 0 294980 2 32
Type DstIP(Port) SrcIP(Port) Pro ToS If(Direc) Pkts
DstMAC(VLAN) SrcMAC(VLAN)
TopLblType(IP/MASK) Lbl-Exp-S-List
---------------------------------------------------------------------------
IP 1.1.1.13(1025) 1.1.1.13(1024) 17 0 GE3/1/8(O) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 32 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(2048) 1.1.1.15(0) 1 0 GE3/1/8(I) 117163
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(1025) 1.1.1.14(1024) 17 0 GE3/1/8(O) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(2048) 1.1.1.15(0) 1 0 GE3/1/8(O) 117163
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP& 198.19.1.1(0) 198.19.1.2(0) 114 0 GE3/1/8(I) 117164
L2 0000-0000-0000(2) 0000-0000-0000(2)
TcpFlag: 0
DstMask: 32 SrcMask: 32 Nexthop: 0.0.0.0
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(0) 1.1.1.12(0) 114 0 GE3/1/8(I) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(1025) 1.1.1.13(1024) 17 0 GE3/1/8(I) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 32 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(1025) 1.1.1.14(1024) 17 0 GE3/1/8(I) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
IP 1.1.1.13(0) 1.1.1.12(0) 114 0 GE3/1/8(O) 117164
TcpFlag: 0
DstMask: 32 SrcMask: 24 Nexthop: 1.1.1.13
DstAS: 0 SrcAS: 0 BgpNexthop: 0.0.0.0
OutVRF: 0 InVRF: 0
SamplerMode: 0 SamplerInt: 0
Table 1 Command output
|
Field |
Description |
|
IP netstream cache information |
Information of NetStream entries in the cache |
|
Stream active timeout (minute) |
Active aging timer in minutes for NetStream entries |
|
Stream inactive timeout(second) |
Inactive aging timer in seconds for NetStream entries |
|
Stream max entry number |
Maximum number of flow entries allowed in the cache |
|
IP Active stream entry number |
Number of active IP flows in the cache |
|
MPLS Active stream entry number |
Number of active MPLS flows in the cache |
|
IPL2 active stream entry number |
Number of active Layer 2 and Layer 3 flows in the cache |
|
IP Stream entries been counted |
Number of IP flows that are counted |
|
MPLS Stream entries been counted |
Number of MPLS flows that are counted |
|
IPL2 stream entries been counted |
Number of Layer 2 and Layer 3 flows that are counted |
|
Last statistics reset time |
This field is an absolute time and will not change with the system time. This field is displayed only when the reset ip netstream statistics command is executed; otherwise, the value for this field is Never. |
|
IP packet size distribution (1103746 total packets): |
Distribution of IP packets by packet size, and the bracketed number is the total number of packets The value is displayed in the proportion of number of IP packets to the total IP packets, and is displayed with 3 decimal places. |
|
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 |
Range of IP packet length (excluding data link layer header), in bytes. In the range of 1 to 576, the range increments in the step of 32. For example, "1-32" shows the number of packets in size of 1 to 32 bytes, and "64" shows the number of packets in size of 33 to 64 bytes. For the value greater than 1024, the range increments in the step of 512. For example, "1536" shows the number of packets in size of 1025 to 1536 bytes. Packets in size of 577 to 1024 are recorded in the 1024 entry. |
|
Protocol Total Streams Packets /Sec Stream /Sec Packets /stream Active(sec) /stream Idle(sec) /stream |
Statistics of packet by protocol type in the following counting criteria: protocol number, total number of flows, number of packets per second, number of flows per second, number of packets per flow, active time of each flow, and inactive time of each flow. |
|
Type DstIP(Port) SrcIP(Port) Pro ToS If(Direc) Pkts |
Statistics of the active flows in the current cache including flow type, destination IP address (destination port), source IP address (source port), protocol, ToS, interface type and name (direction), and the number of packets. Flows are classified into the following types: IP flows, L2 flows, IP&L2 flows, MPLS flows with no IP options, and MPLS flows with IP options. ICMP packets do not contain port number fields, so the type and code fields are captured. The value for the destination port represents these two fields. More specifically, the highest 8 bits represent the type field and the lowest 8 bits represent the code field. The value for the source port is set to 0 and does not indicate any statistics. |
|
DstMAC(VLAN) SrcMAC(VLAN) |
Layer 2 information of the active flows in the current cache, including destination MAC address, destination VLAN ID, source MAC address, and source VLAN ID |
|
TopLblType(IP/MASK) Lbl-Exp-S-List |
Information of the active MPLS flows in the cache, including type of the labels at the top of the label stack (IP address and mask associated with the label), and label list. A label consists of three fields: · Label field, 20 bits in length. · Exp field, for QoS, three bits in length. · S field, one bit in length. The value of 1 indicates that the label is at the bottom of the label stack. At most three labels can be listed in one label list. |
|
TcpFlag: DstMask: SrcMask: Nexthop: DstAS: SrcAS: BgpNexthop: OutVRF: InVRF: SamplerMode: SamplerInt: Active: Bytes/Pkt: |
Other information of the active flows in the current cache, including TCP tag, destination mask, source mask, routing next hop, destination autonomous system (AS), source AS, BGP next hop, VPN to which the outbound packets belong, VPN to which the inbound packets belong, sampling mode (F/D/R), sampling interval, flow active time, and number of bytes in each packet. NetStream supports the following sampling modes: · 0—No sampling. · 1—Fixed sampling. · 2—Random sampling (not supported by SPC cards). |
|
L2 0000-0000-0000 0000-0000-0000 |
Statistics about the MAC addresses of the Layer 2 frames. The router currently does not support collection of such statistics, and displays "0000-0000-0000". |
display ip netstream export
Syntax
display ip netstream export [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display ip netstream export to display statistics about NetStream data export.
Examples
# Display statistics about NetStream data export.
<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 aggregation export information:
Stream source interface : GigabitEthernet3/1/8.1
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)
Table 2 Command output
|
Field |
Description |
|
IP export information |
Statistics about NetStream data export in version 5 |
|
Stream source interface |
Source interface from which the NetStream data is exported |
|
Stream destination vpn-instance |
VPN to which the destination address of the NetStream data export belongs |
|
Stream destination IP (UDP) |
Destination address and port number of NetStream data export (UDP) |
|
Version 5 exported stream number |
Number of flows that are exported in version 5 format |
|
Version 5 exported UDP datagram number (failed) |
Number of UDP packets that are sent in version 5 format (number of packets not successfully sent) |
|
Version 9 exported stream number |
Number of flows that are exported in version 9 format |
|
Version 9 exported UDP datagram number (failed) |
Number of UDP packets that are sent in version 9 format (number of packets not successfully sent) |
|
AS aggregation export information |
Statistics about NetStream AS aggregation in version 8 format. Displayed only when NetStream AS aggregation is enabled. |
|
MPLS export information |
Statistics about MPLS-aware NetStream data export in version 9 |
|
Version 8 exported stream number |
Number of flows that are exported in version 8 format |
|
Version 8 exported UDP datagram number (failed) |
Number of UDP packets that are sent in version 8 format (number of packets not successfully sent) |
display ip netstream template
Syntax
display ip netstream template [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays NetStream template information of a card. The slot-number argument specifies a card by its slot number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display ip netstream template to view configuration and status information about the NetStream flow record template.
· If slot slot-number is provided, the configuration and status information about the NetStream flow record template of a card is displayed.
· If slot slot-number is not provided, the configuration information about NetStream flow record template of all cards is displayed.
Examples
# Display information about the NetStream flow record template
<Sysname> display ip netstream template slot 13
Stream template refresh-rate packet : 20
Stream template refresh-rate time(in minute) : 30
Active stream templates : 6
Added stream templates : 10
IPL2 outbound template:
Template ID : 286
Field count : 21
Field type Field length (byte)
---------------------------------------------------------------------------
Out packets 8
Out bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
IPv4 source address 4
IPv4 destination address 4
Source VLAN 2
Destination VLAN 2
L4 source port 2
L4 destination port 2
IP protocol version 1
TCP flags 1
Protocol 1
Source ToS 1
Direction 1
Sampling algorithm 1
PAD 1
PAD 1
Sampling interval 4
IPL2 inbound template:
Template ID : 285
Field count : 21
Field type Field length (byte)
---------------------------------------------------------------------------
In packets 8
In bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
IPv4 source address 4
IPv4 destination address 4
Source VLAN 2
Destination VLAN 2
L4 source port 2
L4 destination port 2
IP protocol version 1
TCP flags 1
Protocol 1
Source ToS 1
Direction 1
Sampling algorithm 1
PAD 1
PAD 1
Sampling interval 4
L2 outbound template:
Template ID : 284
Field count : 15
Field type Field length (byte)
---------------------------------------------------------------------------
Out packets 8
Out bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
Out source MAC 6
Out destination MAC 6
Source VLAN 2
Destination VLAN 2
Direction 1
Sampling algorithm 1
PAD 1
PAD 1
Sampling interval 4
L2 inbound template:
Template ID : 283
Field count : 15
Field type Field length (byte)
---------------------------------------------------------------------------
In packets 8
In bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
In source MAC 6
In destination MAC 6
Source VLAN 2
Destination VLAN 2
Direction 1
Sampling algorithm 1
PAD 1
PAD 1
Sampling interval 4
IP outbound template:
Template ID : 282
Field count : 25
Field type Field length (byte)
---------------------------------------------------------------------------
Out packets 8
Out bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
IPv4 source address 4
IPv4 destination address 4
IPv4 nexthop 4
Source AS 2
Destination AS 2
L4 source port 2
L4 destination port 2
IP protocol version 1
TCP flags 1
Protocol 1
Source ToS 1
Source mask 1
Destination mask 1
Direction 1
Forwarding offset 1
Out VPN ID 2
Sampling algorithm 1
PAD 1
Sampling interval 4
IP inbound template:
Template ID : 281
Field count : 25
Field type Field length (byte)
---------------------------------------------------------------------------
In packets 8
In bytes 8
First switched 4
Last switched 4
Input SNMP 2
Output SNMP 2
IPv4 source address 4
IPv4 destination address 4
IPv4 nexthop 4
Source AS 2
Destination AS 2
L4 source port 2
L4 destination port 2
IP protocol version 1
TCP flags 1
Protocol 1
Source ToS 1
Source mask 1
Destination mask 1
Direction 1
Forwarding offset 1
In VPN ID 2
Sampling algorithm 1
PAD 1
Sampling interval 4
Table 3 Command output
|
Field |
Description |
|
Stream template refresh-rate packet |
Refresh frequency with which the template is sent |
|
Stream template refresh-rate time(in minute) |
Refresh interval in minutes at which the template is sent |
|
Active stream templates |
Number of active templates |
|
Added stream templates |
Number of templates that have been created |
|
Packets |
Number of packets sent using the template. A packet may contain multiple flows and different flows may use different templates; therefore, the number of packets is in fact the number of flows. |
|
Last template export time |
Time when the last flow record template was exported |
|
Field count |
Total number of fields in a template |
enable
Syntax
enable
undo enable
View
NetStream aggregation view
Default level
3: Manage level
Parameters
None
Description
Use enable to enable current aggregation mode.
Use undo enable to disable current aggregation mode.
By default, no aggregation mode is enabled.
Related commands: ip netstream aggregation.
Examples
# Enable NetStream AS aggregation.
<Sysname> system-view
[Sysname] ip netstream aggregation as
[Sysname-aggregation-as] enable
ip netstream
Syntax
ip netstream
undo ip netstream
View
System view
Default level
3: Manage level
Parameters
None
Description
Use ip netstream to enable NetStream.
Use undo ip netstream to disable NetStream.
By default, NetStream is disabled.
Examples
# Enable NetStream.
<Sysname> system-view
[Sysname] ip netstream
ip netstream aggregation
Syntax
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 }
View
System view
Default level
3: Manage level
Parameters
as: AS aggregation by source AS number, destination AS number, inbound interface index, and outbound interface index.
destination-prefix: Destination-prefix aggregation by destination AS number, destination address mask length, destination prefix, and outbound interface index.
prefix: Source and destination prefix aggregation by source AS number, destination AS number, source address mask length, destination address mask length, source prefix, destination prefix, inbound interface index, and outbound interface index.
prefix-port: Prefix-port aggregation by source prefix, destination prefix, source address mask length, destination address mask length, ToS, protocol number, source port, destination port, inbound interface index, and outbound interface index.
protocol-port: Protocol-port aggregation by protocol number, source port, and destination port.
source-prefix: Source-prefix aggregation by source AS number, source address mask length, source prefix, and inbound interface index.
tos-as: ToS-AS aggregation by ToS, source AS number, destination AS number, inbound interface index, and outbound interface index.
tos-bgp-nexthop: ToS-BGP next hop aggregation by ToS, BGP next hop address, and outbound interface index. ToS-BGP next hop aggregation is effective only under a version 9 template.
tos-destination-prefix: ToS-destination-prefix aggregation by ToS, destination AS number, destination address mask length, destination prefix, and outbound interface index.
tos- prefix: ToS-prefix aggregation by ToS, source AS number, source prefix, source address mask length, destination AS number, destination address mask length, destination prefix, inbound interface index, and outbound interface index.
tos-protocol-port: ToS-protocol-port aggregation by ToS, protocol number, source port, destination port, inbound interface index, and outbound interface index.
tos-source-prefix: ToS-source-prefix aggregation by ToS, source AS number, source prefix, source address mask length, and inbound interface index.
Description
Use ip netstream aggregation to set a NetStream aggregation mode and enter NetStream aggregation view.
Then in the NetStream aggregation view, you can perform the following tasks:
· Enable or disable the specific NetStream aggregation.
· Configure source interface, destination IP address, and destination port for NetStream data export.
Related commands: enable, ip netstream export host, and ip netstream export source.
Examples
# Set the NetStream aggregation mode to AS and enter NetStream AS aggregation view.
<Sysname> system-view
[Sysname] ip netstream aggregation as
[Sysname-aggregation-as]
ip netstream aggregation advanced
Syntax
ip netstream aggregation advanced
undo ip netstream aggregation advanced
View
System view
Default level
3: Manage level
Parameters
None
Description
Use ip netstream aggregation advanced to enable hardware NetStream aggregation.
Use undo ip netstream aggregation advanced to disable hardware NetStream aggregation.
By default, hardware NetStream aggregation is disabled.
The configuration in NetStream aggregation view applies to NetStream hardware aggregation, if enabled.
NetStream hardware aggregation data export and NetStream traditional data export are mutually exclusive. Hardware aggregation does not take effect if the destination address for NetStream traditional data export (configured with the ip netstream export host command in system view) is configured.
NetStream hardware aggregation entries are stored in the cache where NetStream traditional data entries are recorded, and then exported.
Related commands: ip netstream export host and ip netstream aggregation.
|
|
NOTE: Hardware NetStream aggregation is implemented by the NAM card. |
Examples
# Enable hardware NetStream aggregation.
<Sysname> system-view
[Sysname] ip netstream aggregation advanced
ip netstream export host
Syntax
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 ] ]
View
System view, NetStream aggregation view
Default level
3: Manage level
Parameters
ip-address: Destination IP address for NetStream export data.
udp-port: Destination UDP port number for NetStream export data, in the range of 0 to 65535.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN that the NetStream data export destination belongs to. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the destination is on the public network, do not specify this option.
Description
Use ip netstream export host to set the destination address for NetStream data export.
Use undo ip netstream export host to delete a specified export address or all export addresses that are configured in this view.
By default, no destination IP address and UDP port number are configured in system view and the IP address and port number in aggregation view are those configured in system view.
Different destination hosts can be configured in different aggregation views.
Up to four different destination addresses, including addresses in different VPNs, can be configured in one aggregation view. If you have configured the destination addresses with the same IP addresses but different UDP ports, the last configuration takes effect. If you configure different VPN instance names, you can configure destination addresses with the same IP address and UDP port.
NetStream traditional data are exported to all destination addresses configured in system view, and NetStream aggregation data are exported to all destination addresses configured in the related aggregation view. If you expect NetStream aggregation data only, configure the destination address in the aggregation view and do not configure the destination address in system view; otherwise, the NetStream traditional data are also be exported, which will increase the bandwidth occupation.
Related commands: ip netstream aggregation and ip netstream export source.
Examples
# Configure the destination IP address and UDP port number for NetStream export data as 172.16.105.48 and 5000 respectively, and query routes in vpn1.
<Sysname> system-view
[Sysname] ip netstream export host 172.16.105.48 5000 vpn-instance vpn1
ip netstream export rate
Syntax
ip netstream export rate rate
undo ip netstream export rate
View
System view
Default level
3: Manage level
Parameters
rate: Maximum rate for exporting NetStream data, in the unit of the maximum number of packets per second. It is in the range of 1 to 1000.
Description
Use ip netstream export rate to configure the limit on the NetStream data export rate.
Use undo ip netstream export rate to remove the NetStream data export limit.
By default, the export rate of NetStream data is not limited.
|
|
NOTE: The export rate on each card is different. Because the aging timer is different, the configuration may not be very precise on a multi-CPU router. |
Examples
# Allow 10 packets at most to be exported per second.
<Sysname> system-view
[Sysname] ip netstream export rate 10
ip netstream export source
Syntax
ip netstream export source interface interface-type interface-number
undo ip netstream export source
View
System view, NetStream aggregation view
Default level
3: Manage level
Parameters
interface-type interface-number: Specifies a source interface for NetStream data export by its type and number.
Description
Use ip netstream export source to configure the source interface for NetStream data export.
Use undo ip netstream export source to remove the configured source interface.
By default, the interface (where the NetStream data is sent out) connecting to the NetStream server is used as the source interface.
Different source interfaces can be configured in different aggregation views.
If no source interface is configured in aggregation view, the source interface configured in system view is used.
H3C recommends you connect the network management interface to the NetStream server and configure it as the source interface.
Related commands: ip netstream aggregation.
Examples
# Configure the source interface for NetStream data export as M-Ethernet 6/0/0.
<Sysname> system-view
[Sysname] ip netstream export source interface M-Ethernet 6/0/0
ip netstream export v9-template refresh-rate packet
Syntax
ip netstream export v9-template refresh-rate packet packets
undo ip netstream export v9-template refresh-rate packet
View
System view
Default level
3: Manage level
Parameters
packets: Specifies the number of packets that are sent before version 9 templates are sent to the NetStream server for an update. It is in the range of 1 to 600.
Description
Use ip netstream export v9-template refresh-rate packet to configure the refresh frequency for NetStream version 9 templates so that the templates are sent when the specified number of packets are sent.
Use undo ip netstream export v9-template refresh-rate packet to restore the default.
By default, version 9 templates are sent every 20 packets.
Version 9 is template-based and supports user-defined formats, so the NetStream-enabled router needs to send the new template to the NetStream server for an update. If the version 9 format is changed on the router and not updated on the NetStream server, the server is unable to associate the received statistics with its proper fields. To avoid such situation, configure the refresh frequency for version 9 templates so that the NetStream server can refresh them on time.
The refresh frequency and interval can be both configured, and the template is resent when either of the condition is reached.
Related commands: ip netstream export v9-template refresh-rate time.
Examples
# Configure the router to wait until 100 packets are sent before sending NetStream version 9 templates again to the NetStream server.
<Sysname> system-view
[Sysname] ip netstream export v9-template refresh-rate packet 100
ip netstream export v9-template refresh-rate time
Syntax
ip netstream export v9-template refresh-rate time minutes
undo ip netstream export v9-template refresh-rate time
View
System view
Default level
3: Manage level
Parameters
minutes: Specifies the refresh interval in minutes that the router waits after NetStream version 9 templates are sent to the NetStream server. It is in the range of 1 to 3600.
Description
Use ip netstream export v9-template refresh-rate time to configure the refresh interval for NetStream version 9 templates so that the templates are sent after the specified time period.
Use undo ip netstream export version to restore the default.
By default, version 9 templates are resent every 30 minutes.
Version 9 is template-based and supports user-defined formats, so the NetStream-enabled router needs to send the new template to the NetStream server for an update. If the version 9 format is changed on the router and not updated on the NetStream server, the server is unable to associate the received statistics with its proper fields. To avoid such situation, configure the refresh interval for version 9 templates so that the NetStream server can refresh them on time.
The refresh frequency and interval can be both configured, and the template is resent when either of the condition is reached.
Related commands: ip netstream export v9-template refresh-rate packet.
Examples
# Set the interval to send templates of NetStream export data in version 9 format to 60 minutes.
<Sysname> system-view
[Sysname] ip netstream export v9-template refresh-rate time 60
ip netstream export version
Syntax
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
View
System view
Default level
3: Manage level
Parameters
origin-as: Specifies to export statistics of the source AS that originating the route for the source address and the destination AS for the destination address.
peer-as: Specifies to export statistics of the peer ASs for the source and destination address.
bgp-nexthop: Specifies to export statistics about BGP next hops.
Description
Use ip netstream export version 5 to export NetStream data in version 5 format, and choose whether to record data about AS information. A NetStream entry for a flow records the source IP address and destination IP address, and two AS numbers for each IP address. You can choose to configure which AS numbers to be exported as the source AS and destination AS.
Use ip netstream export version 9 to export NetStream data in version 9 format, and choose whether to record data about AS and BGP next hop information. Statistics about BGP next hop can be exported in version 9 format only.
Use undo ip netstream export version to restore the default.
By default, NetStream traditional data export uses version 5 format; NetStream aggregation data export uses version 8 format; MPLS flow data are not exported; the peer AS numbers are exported; the BGP next hop is not exported.
Examples
# Configure the device to export NetStream data in version 5 format and specify the NetStream data to include the source AS and destination AS.
<Sysname> system-view
[Sysname] ip netstream export version 5 origin-as
ip netstream max-entry
Syntax
ip netstream max-entry { max-entries | aging | disable-caching }
undo ip netstream max-entry
View
System view
Default level
3: Manage level
Parameters
max-entries: Specifies the maximum number of entries that the cache can save. This argument is effective on each card.
aging: Ages out the entries in the cache when the maximum number is reached.
disable-caching: Disables creation of a new entry when the maximum number is reached.
Description
Use ip netstream max-entry to configure the maximum number of NetStream entries that the cache can accommodate, and configure whether to age out the entries or disable creation of a new entry when the number of entries in the cache reaches the upper limit.
Use undo ip netstream max-entry to restore the default.
By default, the maximum number of entries that the NetStream cache can accommodate is 409600, and when the number of entries in a cache reaches the upper limit, they are aged out.
Examples
# Set the maximum entries in the cache to 65536.
<Sysname> system-view
[Sysname] ip netstream max-entry 65536
# Disable creation of a new entry when the upper limit is reached.
<Sysname> system-view
[Sysname] ip netstream max-entry disable-caching
# Configure to age out the entries when the upper limit is reached.
<Sysname> system-view
[Sysname] ip netstream max-entry aging
ip netstream mirror-to
Syntax
ip netstream mirror-to interface Net-Stream interface-number [ backup-interface Net-Stream interface-number ] { inbound | outbound }
undo ip netstream mirror-to { inbound | outbound }
View
Interface view
Default level
3: Manage level
Parameters
Net-Stream interface-number: Specifies the primary destination interface to which traffic is mirrored.
backup-interface Net-Stream interface-number: Specifies a backup destination interface to which traffic is mirrored.
inbound: Mirrors inbound traffic.
outbound: Mirrors outbound traffic.
Description
Use ip netstream mirror-to to mirror traffic to an interface for NetStream statistics collection.
Use undo ip netstream mirror-to to cancel the traffic mirroring.
By default, the interface does not mirror traffic to a NetStream interface.
This feature is supported on SPC cards only.
Examples
# Configure to mirror the inbound traffic of interface GigabitEthernet 3/0/1 to NetStream interface 2/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
ip netstream mpls
Syntax
ip netstream mpls [ label-positions label-position1 [ label-position2 [ label-position3 ] ] ] [ no-ip-fields ]
undo ip netstream mpls
View
System view
Default level
3: Manage level
Parameters
label-positions: Specifies position of the labels to be counted.
no-ip-fields: IP options are not counted.
label-position1: Position of the first label to be counted, in the range of 1 to 6.
label-position2: Position of the second label to be counted, in the range of 1 to 6.
label-position3: Position of the third label to be counted, in the range of 1 to 6.
Description
Use ip netstream mpls to count and export MPLS packets. By using the no-ip-fields keyword, you can set whether to carry IP options when exporting MPLS packets. If you do not provide any arguments, the first label is used and IP options are carried in MPLS packets.
Use undo ip netstream mpls to disable counting and exporting of MPLS packets.
By default, counting and exporting of MPLS packets are disabled.
Collection of NetStream MPLS packet statistics is supported only when NetStream is enabled.
To collect statistics about MPLS packets carrying IPv4 data, enable IPv4 NetStream.
To collect statistics about MPLS packets carrying IPv6 data, enable IPv6 NetStream.
To collect statistics about MPLS packets carrying neither IPv4 nor IPv6 data, enable IPv4 NetStream.
On a NAM card, to collect statistics about MPLS packets carrying non-IPv4 data, enable IPv4 NetStream. Only the statistics about labels are collected.
Examples
# Enable MPLS NetStream, and export MPLS packets with the first, second and third labels and IP contents being counted.
<Sysname> system-view
[Sysname] ip netstream mpls label-positions 1 2 3
ip netstream sampler
Syntax
ip netstream sampler sampler-name { inbound | outbound }
undo ip netstream sampler sampler-name { inbound | outbound }
View
Interface view
Default level
3: Manage level
Parameters
sampler sampler-name: Sampler name, a string of up to 32 characters.
inbound: Enables NetStream sampling in the inbound direction.
outbound: Enables NetStream sampling in the outbound direction.
Description
Use ip netstream sampler to enable NetStream sampling.
Use undo ip netstream sampler to disable NetStream sampling.
By default, NetStream sampling is disabled.
This feature is supported by SPC cards only.
Examples
# Enable NetStream sampling in the inbound direction of GigabitEthernet 3/0/1 by referencing sampler abc.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/1
[Sysname-GigabitEthernet3/0/1] ip netstream sampler abc inbound
ip netstream timeout active
Syntax
ip netstream timeout active minutes
undo ip netstream timeout active
View
System view
Default level
3: Manage level
Parameters
minutes: Sets the aging timer in minutes for active flows. It is in the range of 1 to 60.
Description
Use ip netstream timeout active to set the aging timer for active flows.
Use undo ip netstream timeout active to restore the default.
By default, the aging timer is 30 minutes for active flows.
Related commands: ip netstream timeout inactive.
|
|
NOTE: · The aging timers for active flows and inactive flows apply to NetStream traditional data flows. · You can configure both the aging timer for active flows and the aging timer for inactive flows. When either timer for a flow expires, the flow is aged out. The time precision is 10 seconds. |
Examples
# Set the aging timer to 60 minutes for active flows.
<Sysname> system-view
[Sysname] ip netstream timeout active 60
ip netstream timeout inactive
Syntax
ip netstream timeout inactive seconds
undo ip netstream timeout inactive
View
System view
Default level
3: Manage level
Parameters
seconds: Sets the aging timer in seconds for inactive flows. It is in the range of 10 to 600.
Description
Use ip netstream timeout inactive to set the aging timer for inactive flows.
Use undo ip netstream timeout inactive to restore the default.
By default, the aging timer is 30 seconds for inactive flows.
Related commands: ip netstream timeout active.
|
|
NOTE: · The aging timers for active flows and inactive flows apply to NetStream traditional data flows. · You can configure both the aging timer for active flows and the aging timer for inactive flows. When either timer for a flow expires, the flow is aged out. The time precision is 10 seconds. |
Examples
# Set the aging timer to 60 seconds for inactive flows.
<Sysname> system-view
[Sysname] ip netstream timeout inactive 60
mirror-to interface
Syntax
mirror-to interface Net-Stream interface-number [ backup-interface Net-Stream interface-number ] sampler sampler-name
undo mirror-to interface interface-type interface-number
View
Traffic behavior view
Default level
2: System level
Parameters
Net-Stream interface-number: Specifies the primary destination interface to which traffic is mirrored.
backup-interface Net-Stream interface-number: Specifies a backup destination interface to which traffic is mirrored.
sampler-name: Specifies a sampler by its name.
Description
Use mirror-to interface to configure the action of mirroring traffic to a specified NetStream interface on an NetStream-capable card (SPC, SPE, or NAM card) for the traffic behavior.
Use undo mirror-to interface to remove the action.
By default, the action of mirroring traffic to an interface is not configured for a traffic behavior.
Examples
# Configure traffic mirroring for traffic behavior ns, with the destination interface as Net-Stream 4/0/1 and the backup one as Net-Stream 10/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
reset ip netstream statistics
Syntax
reset ip netstream statistics
View
User view
Default level
2: System level
Parameters
None
Description
Use reset ip netstream statistics to age and export NetStream data and clear the cache.
When the system is clearing the cache, the operation may take several minutes and the system does not perform NetStream during this process.
Examples
# Age and export all NetStream data, and clear the cache.
<Sysname> reset ip netstream statistics
This process may take a few minutes.
Netstream statistic function is disabled during this process.
