- Table of Contents
-
- 11-NMM Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-iNQA commands
- 04-NTP commands
- 05-PoE commands
- 06-SNMP commands
- 07-RMON commands
- 08-Event MIB commands
- 09-NETCONF commands
- 10-SmartMC commands
- 11-EPA commands
- 12-ONVIF commands
- 13-CWMP commands
- 14-EAA commands
- 15-Process monitoring and maintenance commands
- 16-Sampler commands
- 17-Mirroring commands
- 18-NetStream commands
- 19-IPv6 NetStream commands
- 20-sFlow commands
- 21-Information center commands
- 22-Packet capture commands
- 23-VCF fabric commands
- 24-Cloud connection commands
- 25-EPS agent commands
- 26-eMDI commands
- 27-SQA commands
- Related Documents
-
Title | Size | Download |
---|---|---|
18-NetStream commands | 140.41 KB |
Contents
display fpga-working-mode status
ip netstream export template refresh-rate
Session-based NetStream commands
display fpga-working-mode status
display session-based netstream aggregation-cache
session-based netstream enable
session-based netstream export host
session-based netstream export source ip
session-based netstream session-timeout
session-based netstream timeout
NetStream commands
display fpga-working-mode status
Use display fpga-working-mode status to display the working mode of a NetStream interface extension module.
Syntax
display fpga-working-mode status slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
Examples
# Display the working mode of a NetStream interface extension module.
[Sysname] display fpga-working-mode status slot 1
Slot 1 Fpga-working-mode status:
Fpga-work-mode in use: NORMAL MODE(default).
Fpga-work-mode for next reboot: NORMAL MODE(default).
Table 1 Command output
Field |
Description |
Fpga-work-mode in use |
Current working mode of the NetStream interface extension module: · NORMAL MODE—In this mode, the device does not support NetStream. · NETSTREAM—In this mode, the NetStream interface extension module works in the unidirectional NetStream mode. · NETSTREAM SESSION—In this mode, the NetStream interface extension module works in the bidirectional session-based NetStream mode. |
Fpga-work-mode for next reboot |
The working mode of the NetStream interface extension module for next reboot: · NORMAL MODE—In this mode, the device does not support NetStream. · NETSTREAM—In this mode, the NetStream interface extension module works in the unidirectional NetStream mode. · NETSTREAM SESSION—In this mode, the NetStream interface extension module works in the bidirectional session-based NetStream mode. |
Related commands
fpga-working-mode
display ip netstream cache
Use display ip netstream cache to display NetStream entry information.
Syntax
display ip netstream cache [ verbose ] [ type { ip | ipl2 | l2 } ] [ destination destination-ip | interface interface-type interface-number | source source-ip ] * [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
verbose: Displays detailed information about NetStream entries. If you do not specify this keyword, this command displays brief information about NetStream entries.
type: Specifies the NetStream entry type. If you do not specify this keyword, this commands displays information about all types of NetStream entries.
ip: Specifies Layer 3 NetStream entries.
ipl2: Specifies Layer 2 and Layer 3 NetStream entries.
l2: Specifies Layer 2 NetStream entries.
destination destination-ip: Specifies a destination IP address in dotted-decimal notation. If you specify this option, this command does not display Layer 2 NetStream entries.
interface interface-type interface-number: Specifies an interface by its type and number.
source source-ip: Specifies a source IP address in dotted-decimal notation. If you specify this option, this command does not display Layer 2 NetStream entries.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays information about NetStream entries for all member devices.
Usage guidelines
The types of NetStream entries for flow packets vary by the export template version and whether the flow packets contain IP headers.
· If the version 9 or version 10 template is used:
¡ The type of the NetStream entry is ipl2 (Layer 2 and Layer 3) for flow packets containing IP headers.
¡ The type of the Netstream entry is l2 (Layer 2) for flow packets without IP headers.
· If the version 5 template is used:
¡ The type of the NetStream entry is ip (Layer 3) for flow packets containing IP headers.
¡ The type of the NetStream entry is l2 (Layer 2) for flow packets without IP headers.
Examples
# Display detailed information about NetStream entries.
<Sysname> display ip netstream cache verbose
IP NetStream cache information:
Active flow timeout : 5 min
Inactive flow timeout : 300 sec
Max number of entries : 1048576
IP active flow entries : 1
MPLS active flow entries : 0
L2 active flow entries : 1
IPL2 active flow entries : 1
IP flow entries counted : 10
MPLS flow entries counted : 0
L2 flow entries counted : 10
IPL2 flow entries counted : 20
Last statistics resetting time : 01/01/2019 at 00:01:02
IP packet size distribution (1103746 packets in total):
1-32 64 96 128 160 192 224 256 288 320 352 384 416 448 480
.249 .694 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000
512 544 576 1024 1536 2048 2560 3072 3584 4096 4608 >4608
.000 .000 .027 .000 .027 .000 .000 .000 .000 .000 .000 .000
Protocol Total Packets Flows Packets Active(sec) Idle(sec)
Flows /sec /sec /flow /flow /flow
--------------------------------------------------------------------------
TCP-Telnet 2656855 372 4 86 49 27
TCP-FTP 5900082 86 9 9 11 33
TCP-FTPD 3200453 1006 5 193 45 33
TCP-WWW 546778274 11170 887 12 8 32
TCP-other 49148540 3752 79 47 30 32
UDP-DNS 117240379 570 190 3 7 34
UDP-other 45502422 2272 73 30 8 37
ICMP 14837957 125 24 5 12 34
IP-other 77406 5 0 47 52 27
Type DstIP(Port) SrcIP(Port) Pro ToS VNI If(Direct) Pkts
DstMAC(VLAN) SrcMAC(VLAN)
TopLblType(IP/Mask) Lbl-Exp-S-List
--------------------------------------------------------------------------
IP 11.1.1.1(1024) 11.1.1.2(21) 6 128 10 GE1/0/1(I) 42996
TCPFlag: 27
DstMask: 24 SrcMask: 24 NextHop: 0.0.0.0
DstAS: 0 SrcAS: 0 BGPNextHop: 0.0.0.0
InVRF: 10
SamplerMode: 2 SamplerInt: 256
Active: 120.600 Bytes/Pkt: 152
First packet arrived: 10/28/2019, 14:10:03
Last packet arrived: 10/28/2019, 14:21:03
L2 0012-3f86-e94c(10) 0012-3f86-e86a(0) GE1/0/1(I) 1253
SamplerMode: 2 SamplerInt: 64
Active: 5.510 Bytes/Pkt: 210
First packet arrived: 10/28/2019, 14:10:00
Last packet arrived: 10/28/2019, 14:21:03
IP& 192.168.123.1(2048) 192.168.1.1(0) 1 0 N/A GE1/0/2(O) 10
L2 0012-3f86-e95d(0) 0012-3f86-e116(1008)
TCPFlag: 27
DstMask: 24 SrcMask: 24 NextHop: 192.168.1.2
DstAS: 0 SrcAS: 0 BGPNextHop: 0.0.0.0
OutVRF: 0 TCPFlag: 0
SamplerMode: 0 SamplerInt: 0
Active: 12.030 Bytes/Pkt: 86
First packet arrived: 10/28/2019, 14:10:04
Last packet arrived: 10/28/2019, 14:21:03
IP& 172.16.1.1(68) 172.16.2.1(67) 17 64 N/A GE1/0/3(I) 1848
Table 2 Command output
Field |
Description |
Active flow timeout |
Aging timer for active flows, in minutes. |
Inactive flow timeout |
Aging timer for inactive flows, in seconds. |
Max number of entries |
Maximum number of flows allowed in the cache. |
IP active flow entries |
Number of active IP flows in the cache. |
MPLS active flow entries |
This field is not supported in the current software version. Number of active MPLS flows in the cache. |
L2 active flow entries |
Number of active Layer 2 flows in the cache. |
IPL2 active flow entries |
Number of active Layer 2 and Layer 3 flows in the cache. |
IP flow entries counted |
Number of IP flows that have been counted. |
MPLS flow entries counted |
This field is not supported in the current software version. Number of MPLS flows that have been counted. |
L2 flow entries counted |
Number of Layer 2 flows that have been counted. |
IPL2 flow entries counted |
Number of Layer 2 and Layer 3 flows that have been counted. |
Last statistics resetting time |
Last time the reset ip netstream statistics command was executed. This field displays Never if you have never executed this command. |
IP packet size distribution (1103746 packets in total) |
Distribution of IP packets by packet size, and the bracketed number is the total number of IP packets. The value is displayed in the proportion of the number of IP packets of the specified sizes to the total number of IP packets, and the value 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. · For the values in the range of 1 to 576, the range increases in the step of 32. For example, 1-32 shows the number of packets with the size of 1 to 32 bytes. 64 shows the number of packets with the size of 33 to 64 bytes. · For the values greater than 1024, the range increases in the step of 512. For example, 1536 shows the number of packets with the size of 1025 to 1536 bytes. · Packets with the size of 577 to 1024 bytes are recorded in the 1024 entry. |
Protocol Total Flows Packets /sec Flows/sec Packets/flow Active(sec)/flow Idle(sec)/flow |
Statistics of packets by protocol type: · Protocol type. · Total number of flows. · Number of packets per second. · Number of flows per second. · Number of packets per flow. · Active time (in seconds) of each flow. · Inactive time (in seconds) of each flow. |
Type DstIP(Port) SrcIP(Port) Pro ToS VNI If(Direct) Pkts |
Statistics of the active flows in the current cache: · Flow type. Flows are classified into the following types: ¡ Layer 3 flows. ¡ Layer 2 flows. ¡ Layer 2 and Layer 3 flows. ¡ MPLS flows without IP options. This field is not supported in the current software version. ¡ MPLS flows with IP options. This field is not supported in the current software version. · Destination IP address (destination port). · Source IP address (source port). · Protocol number. · ToS. · VXLAN ID. · Interface name (direction). · Number of packets. 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: · The highest 8 bits represent the type field. · 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: · Destination MAC address, followed by the destination VLAN ID in parenthesis. · Source MAC address, followed by the source VLAN ID in parenthesis. |
TopLblType(IP/Mask) Lbl-Exp-S-List |
This field is not supported in the current software version. Information about the active MPLS flows in the current cache: · Type of the labels at the top of the label stack: ¡ IP address associated with the label. ¡ Mask associated with the label. · Label list. Up to three labels can be listed in one label list. |
TCPFlag: DstMask: SrcMask: NextHop: DstAS: SrcAS: BGPNextHop: OutVRF: InVRF: SamplerMode: SamplerInt: Active: Bytes/Pkt: First packet arrived: Last packet arrived: |
Other information about the active flows in the cache: · TCP tag. · Destination mask. · Source mask. · Routing next hop. · Destination AS. · Source AS. · BGP next hop. · VPN instance to which the outbound packets belong. · VPN instance to which the inbound packets belong. · · Sampling mode. Supported sampling modes are: ¡ 0—No sampling. ¡ 1—Fixed sampling. ¡ 2—Random sampling. · Sampling interval. · Flow's active time. · Number of bytes per packet. · Arrival time of the first packet of the flow. · Arrival time of the last packet of the flow. |
display ip netstream export
Use display ip netstream export to display information about the NetStream data export.
Syntax
display ip netstream export
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display information about the NetStream data export.
<Sysname> display ip netstream export
IP export information:
Flow source interface : GigabitEthernet1/0/1
Flow destination VPN instance : VPN1
Flow destination IP address (UDP) : 10.10.0.10 (30000)
Version 5 exported flow number : 16
Version 5 exported UDP datagram number (failed) : 16 (0)
Version 9 exported flow number : 20
Version 9 exported UDP datagram number (failed) : 2 (0)
Version 10 exported flow number : 0
Version 10 exported UDP datagram number (failed) : 0 (0)
Table 3 Command output
Field |
Description |
IP export information |
NetStream data export information. |
Flow source interface |
Source interface from which the NetStream data is exported. |
Flow destination VPN instance |
VPN to which the destination address of the NetStream data export belongs. |
Flow destination IP address (UDP) |
Destination IP address and UDP port number of the NetStream data export. |
Version 5 exported flow 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. The field in the parentheses indicates the number of UDP packets that failed to be sent. |
Version 9 exported flow 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. The field in the parentheses indicates the number of UDP packets that failed to be sent. |
L2 export information |
Statistics of the Layer 2 data export. |
Version 8 exported flow 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. The field in the parentheses indicates the number of UDP packets that failed to be sent. |
Version 10 exported flow number |
Number of flows that are exported in version 10 format. |
Version 10 exported UDP datagram number (failed) |
Number of UDP packets that are sent in version 10 format. The field in the parentheses indicates the number of UDP packets that failed to be sent. |
display ip netstream template
Use display ip netstream template to display NetStream template information.
Syntax
display ip netstream template [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays NetStream template information for the master device.
Examples
# Display NetStream template information.
<Sysname> display ip netstream template
Flow template refresh frequency : 20
Flow template refresh interval : 30 min
Active flow templates : 6
Created flow templates : 6
L2L3 outbound template:
Template ID : 3286
Field count : 24
Field type Field length (bytes)
------------------------------------------------------------------------------
Out packets 8
Out bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
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
Vxlan ID 4
Source AS 4
Destination AS 4
L2L3 inbound template:
Template ID : 3285
Field count : 24
Field type Field length (bytes)
------------------------------------------------------------------------------
In packets 8
In bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
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
Vxlan ID 4
Source AS 4
Destination AS 4
L2 outbound template:
Template ID : 3284
Field count : 16
Field type Field length (bytes)
------------------------------------------------------------------------------
Out packets 8
Out bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
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
Vxlan ID 4
L2 inbound template:
Template ID : 3283
Field count : 16
Field type Field length (bytes)
------------------------------------------------------------------------------
In packets 8
In bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
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
Vxlan ID 4
L3 outbound template:
Template ID : 3282
Field count : 27
Field type Field length (bytes)
------------------------------------------------------------------------------
Out packets 8
Out bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
IPv4 source address 4
IPv4 destination address 4
IPv4 NextHop 4
Source AS 4
Destination AS 4
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
Vxlan ID 4
APP ID 4
L3 inbound template:
Template ID : 3281
Field count : 27
Field type Field length (bytes)
------------------------------------------------------------------------------
In packets 8
In bytes 8
First forwarded 4
Last forwarded 4
Input Interface Index 4
Output Interface Index 4
IPv4 source address 4
IPv4 destination address 4
IPv4 NextHop 4
Source AS 4
Destination AS 4
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
Vxlan ID 4
APP ID 4
Table 4 Command output
Field |
Description |
|
Flow template refresh frequency |
Refresh frequency at which the templates are sent, in packets. |
|
Flow template refresh interval |
Refresh interval at which the templates are sent, in minutes. |
|
Active flow templates |
Number of active NetStream templates. |
|
Created flow templates |
Number of templates that have been created. |
|
Packets |
Number of packets sent by using the template. |
|
Last template export time |
Time when the template was last exported. |
|
Field count |
Total number of fields in a template. |
|
Field type |
Type of a field in the template. |
|
Out packets |
Number of sent packets. |
|
In packets |
Number of received packets. |
|
Out bytes |
Size of sent packets, in bytes. |
|
In bytes |
Size of received packets, in bytes. |
|
First forwarded |
System time when the first packet was forwarded, accurate to milliseconds. |
|
Last forwarded |
System time when the last packet was forwarded, accurate to milliseconds. |
|
L4 source port |
Source UDP or TCP port. |
|
L4 destination port |
Destination UDP or TCP port. |
|
PAD |
Padding string. |
|
Sampling interval |
Sampling rate. |
fpga-working-mode
Use fpga-working-mode to specify a working mode for a NetStream interface extension module.
Syntax
fpga-working-mode slot slot-number { 0 | 1 | 2 }
Default
A NetStream interface extension module works in mode 0 and the device does not support NetStream.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
0: Specifies the normal mode. NetStream is not supported.
1: Specifies the NetStream mode. The NetStream interface extension module works in the unidirectional NetStream mode.
2: Specifies the session-based NetStream mode. The NetStream interface extension module works in the session-based bidirectional NetStream mode.
Usage guidelines
To make the configuration take effect, save the configuration and reboot the device. Before rebooting the device, evaluate the effect of the device reboot on the network.
Examples
# Configure a NetStream interface extension module to work in the unidirectional NetStream mode.
<Sysname> system-view
[Sysname] fpga-working-mode slot 1 1
Related commands
display fpga-working-mode status
ip netstream
Use ip netstream to enable NetStream on an interface.
Use undo ip netstream to disable NetStream on an interface.
Syntax
ip netstream { inbound | outbound }
undo ip netstream { inbound | outbound }
Default
NetStream is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
inbound: Enables NetStream for incoming traffic.
outbound: Enables NetStream for outgoing traffic.
Examples
# Enable NetStream for incoming traffic on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] ip netstream inbound
ip netstream export host
Use ip netstream export host to specify a destination host for NetStream data export.
Use undo ip netstream export host to remove the specified destination host or all destination hosts that are configured in the current view.
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 ] ]
Default
No destination host is specified for NetStream data export.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the destination IP address.
udp-port: Specifies the destination UDP port number in the range of 0 to 65535.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the destination host belongs. 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.
Usage guidelines
You can specify a maximum of four destination hosts in system view or a NetStream aggregation mode view. If you specify a destination host with the same IP address but different UDP ports in the same view, the most recent configuration takes effect. You can specify destination hosts with the same IP address and UDP port but different VPN instances.
NetStream traditional data is exported to all destination hosts in system view.
Examples
# In system view, specify 172.16.105.48 as the IP address of the destination host and UDP port 5000 as the export destination port number.
<Sysname> system-view
[Sysname] ip netstream export host 172.16.105.48 5000
Related commands
ip netstream export source
ip netstream export rate
Use ip netstream export rate to limit the NetStream data export rate.
Use undo ip netstream export rate to restore the default.
Syntax
ip netstream export rate rate
undo ip netstream export rate
Default
The export rate of NetStream data is not limited.
Views
System view
Predefined user roles
network-admin
Parameters
rate: Specifies the export rate in the range of 1 to 1000.
Usage guidelines
This command sets the maximum number of NetStream packets that can be exported per second. Packets that cannot be exported due to the export rate limit are buffered for later export. When the buffer is full, the system will temporarily invalidate the rate limit and export packets as fast as possible until the buffer has space for new packets.
Examples
# Allow a maximum of 10 packets to be exported per second.
<Sysname> system-view
[Sysname] ip netstream export rate 10
ip netstream export source
Use ip netstream export source to specify the source interface for data packets sent to NetStream servers.
Use undo ip netstream export source to restore the default.
Syntax
ip netstream export source interface interface-type interface-number
undo ip netstream export source
Default
The packets take the IP address of the output interface as the source IP address.
Views
System view
Predefined user roles
network-admin
Parameters
interface-type interface-number: Specifies a source interface by its type and number.
Usage guidelines
The IP address of the specified source interface is used as the source IP address for packets sent to NetStream servers.
Examples
# In system view, specify GigabitEthernet 1/0/1 as the source interface for NetStream traditional data packets.
<Sysname> system-view
[Sysname] ip netstream export source interface gigabitethernet 1/0/1
ip netstream export template refresh-rate
Use ip netstream export template refresh-rate to set the refresh rate for the NetStream version 9 or version 10 template.
Use undo ip netstream export template refresh-rate to restore the default.
Syntax
ip netstream export template refresh-rate { packet packets | time minutes }
undo ip netstream export template refresh-rate { packet | time }
Default
The packet count-based refresh rate is 20 packets, and the time-based refresh interval is 30 minutes.
Views
System view
Predefined user roles
network-admin
Parameters
packets: Specifies the number of packets that are sent before the template is sent. The value range is 1 to 600.
time minutes: Specifies the interval at which the template is sent, in the range of 1 to 3600 minutes.
Usage guidelines
Version 9 and version 10 are template-based and support user-defined formats. A NetStream device must send the version 9 or version 10 template to NetStream servers regularly, because the servers do not permanently save the templates.
The refresh rate can be packet count-based or time-based. If both settings are configured, the template is sent when either of the conditions is met.
Examples
# Configure the device to send the Netstream version 9 or version 10 template to NetStream servers every 100 packets.
<Sysname> system-view
[Sysname] ip netstream export template refresh-rate packet 100
ip netstream export version
Use ip netstream export version 5 to export NetStream data in the version 5 format and choose whether to record AS information.
Use ip netstream export version 9 to export NetStream data in the version 9 format and choose whether to record AS and BGP next hop information.
Use ip netstream export version 10 to export NetStream data in the version 10 format and choose whether to record AS and BGP next hop information.
Use undo ip netstream export version to restore the default.
Syntax
ip netstream export version 5 { origin-as | peer-as }
ip netstream export version { 9 | 10 } { origin-as | peer-as } [ bgp-nexthop ]
undo ip netstream export version
Default
NetStream traditional data export uses the version 9 format. The peer AS numbers are exported. The BGP next hop is not recorded.
Views
System view
Predefined user roles
network-admin
Parameters
origin-as: Records the source AS of the source address and the destination AS of the destination address.
peer-as: Records the ASs before and after the AS where the NetStream device resides as the source AS and destination AS, respectively.
bgp-nexthop: Records BGP next hops.
Usage guidelines
A NetStream entry 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 are to be exported as the source AS and destination AS.
Only version 9 and version 10 formats support recoding BGP next hop data.
Only one version format can take effect on the device. If you execute the command multiple times, the most recent configuration takes effect.
Examples
# Configure the device to export NetStream data in the 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 sampler
Use ip netstream sampler to enable NetStream sampling.
Use undo ip netstream sampler to disable NetStream sampling.
Syntax
ip netstream { inbound | outbound } sampler sampler-name
undo ip netstream { inbound | outbound } sampler
Default
NetStream sampling is disabled.
Views
Interface view
Predefined user roles
network-admin
Parameters
inbound: Enables NetStream sampling in the inbound direction.
outbound: Enables NetStream sampling in the outbound direction.
sampler sampler-name: Specifies a sampler by its name. The name is a case-insensitive string of 1 to 31 characters.
Usage guidelines
By default, NetStream collects all data of target flows. If the flow traffic is heavy, NetStream is resource-consuming and can cause high CPU usage, which impacts the device forwarding performance. NetStream sampling is helpful to decrease the NetStream traffic volume. If the collected statistics can basically reflect the network status, you can enable this feature and set a proper sampling rate. The higher the sampling rate, the less impact on device performance.
Examples
# Use sampler abc for inbound NetStream sampling on GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] ip netstream inbound
[Sysname-GigabitEthernet1/0/1] ip netstream inbound sampler abc
ip netstream timeout active
Use ip netstream timeout active to set the aging timer for active flows.
Use undo ip netstream timeout active to restore the default.
Syntax
ip netstream timeout active minutes
undo ip netstream timeout active
Default
The aging timer is 5 minutes for active flows.
Views
System view
Predefined user roles
network-admin
Parameters
minutes: Sets the aging timer for active flows, in the range of 1 to 60 minutes.
Usage guidelines
A flow is considered active if packets for the NetStream entry arrive before the timer set by this command expires.
Examples
# Set the aging timer to 60 minutes for active flows.
<Sysname> system-view
[Sysname] ip netstream timeout active 60
ip netstream timeout inactive
ip netstream timeout inactive
Use ip netstream timeout inactive to set the aging timer for inactive flows.
Use undo ip netstream timeout inactive to restore the default.
Syntax
ip netstream timeout inactive seconds
undo ip netstream timeout inactive
Default
The aging timer is 300 seconds for inactive flows.
Views
System view
Predefined user roles
network-admin
Parameters
seconds: Sets the aging timer for inactive flows, in the range of 10 to 3600 seconds.
Usage guidelines
A flow is considered inactive if no packet for the NetStream entry arrives before the timer set by this command expires.
Examples
# Set the aging timer to 60 seconds for inactive flows.
<Sysname> system-view
[Sysname] ip netstream timeout inactive 60
ip netstream timeout active
reset ip netstream statistics
Use reset ip netstream statistics to clear the NetStream cache and export the cached entries to NetStream servers.
Syntax
reset ip netstream statistics
Views
User view
Predefined user roles
network-admin
Usage guidelines
It takes the system several minutes to execute the command. During this period, the system does not collect NetStream data.
Examples
# Clear the NetStream cache and export the cached data to NetStream servers.
<Sysname> reset ip netstream statistics
This process may take a few minutes.
Netstream statistic function is disabled during this process.
Session-based NetStream commands
display fpga-working-mode status
Use display fpga-working-mode status to display the working mode of a NetStream interface extension module.
Syntax
display fpga-working-mode status slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
Examples
# Display the working mode of a NetStream interface extension module.
[Sysname] display fpga-working-mode status slot 1
Slot 1 Fpga-working-mode status:
Fpga-work-mode in use: NORMAL MODE(default).
Fpga-work-mode for next reboot: NORMAL MODE(default).
Table 5 Command output
Field |
Description |
Fpga-work-mode in use |
Current working mode of the NetStream interface extension module: · NORMAL MODE—In this mode, the device does not support NetStream. · NETSTREAM—In this mode, the NetStream interface extension module works in the unidirectional NetStream mode. · NETSTREAM SESSION—In this mode, the NetStream interface extension module works in the bidirectional session-based NetStream mode. |
Fpga-work-mode for next reboot |
The working mode of the NetStream interface extension module for next reboot: · NORMAL MODE—In this mode, the device does not support NetStream. · NETSTREAM—In this mode, the NetStream interface extension module works in the unidirectional NetStream mode. · NETSTREAM SESSION—In this mode, the NetStream interface extension module works in the bidirectional session-based NetStream mode. |
Related commands
fpga-working-mode
display session-based netstream aggregation-cache
Use display session-based netstream aggregation-cache to display session-based NetStream statistics.
Syntax
display session-based netstream aggregation-cache session [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
session: Specifies the session aggregation mode. The aggregation criteria of this mode include source MAC address, destination MAC address, source IP address, destination IP address, source port number, destination port number, and protocol type.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays session-based NetStream statistics on all IRF member devices.
Examples
# Display statistics about session-based NetStream in session aggregation mode.
<Sysname> display session-based netstream aggregation-cache session
Active entries :1
Timeout time for session-based NetStream entries :10
Session-timeout time for session-based NetStream entries :400
SrcMAC DstMAC SrcIP DstIP SrcPort DstPort
InPkts InBytes OutPkts OutBytes Pro LogType
0001-0001-0001 0002-0002-0002 192.168.1.1 192.168.2.1 4000 5000
4 240 4 240 6 0x
Table 6 Command output
Field |
Description |
Active entries |
Number of active session-based NetStream entries. |
Timeout time for session-based NetStream entries |
Maximum period of time in minutes a session-based NetStream entry can be cached before being exported to NetStream servers. |
Session-timeout time for session-based NetStream entries |
Aging timer for inactive sessions, in seconds. |
SrcMAC |
Source MAC address. |
DstMAC |
Destination MAC address. |
SrcIP |
Source IP address. |
DstIP |
Destination IP address. |
SrcPort |
Source port number. |
DstPort |
Destination port number. |
InPkts |
Number of upstream packets. |
InBytes |
Number of upstream bytes. |
OutPkts |
Number of downstream packets. |
OutBytes |
Number of downstream bytes. |
Pro |
Protocol number. |
LogType |
Type of the log entry: · 0x1—Entry creation. · 0x2—Entry update. · 0x3—Entry creation and update. · 0x4—Entry ending. · 0x5—Entry creation and ending. · 0x6—Entry creation, update, and ending. |
fpga-working-mode
Use fpga-working-mode to specify a working mode for a NetStream interface extension module.
Syntax
fpga-working-mode slot slot-number { 0 | 1 | 2 }
Default
A NetStream interface extension module works in mode 0 and the device does not support NetStream.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
0: Specifies the normal mode. NetStream is not supported.
1: Specifies the NetStream mode. The NetStream interface extension module works in the unidirectional NetStream mode.
2: Specifies the session-based NetStream mode. The NetStream interface extension module works in the session-based bidirectional NetStream mode.
Usage guidelines
To make the configuration take effect, save the configuration and reboot the device. Before rebooting the device, evaluate the effect of the device reboot on the network.
Examples
# Configure a NetStream interface extension module to work in the session-base NetStream mode.
<Sysname> system-view
[Sysname] fpga-working-mode slot 1 2
Related commands
display fpga-working-mode status
session-based netstream enable
Use session-based netstream enable to enable session-based NetStream.
Use undo session-based netstream enable to disable session-based NetStream.
Syntax
session-based netstream enable
undo session-based netstream enable
Views
System view
Default
Session-based NetStream is disabled.
Predefined user roles
network-admin
Usage guidelines
Session-based NetStream provides statistics for session-based services and exports the statistics in NetStream version 9 format to NetStream servers. The system merges statistics for multiple sessions if each aggregation criterion is of the same value. The aggregation criteria of the session aggregation mode include source MAC address, destination MAC address, source IP address, destination IP address, source port number, destination port number, and protocol type.
Examples
# Enable session-based NetStream.
<Sysname> system-view
[Sysname] session-based netstream enable
session-based netstream export host
Use session-based netstream export host to specify a destination host for session-based NetStream data export.
Use undo session-based netstream export host to restore the default.
Syntax
session-based netstream export host ip-address udp-port [ vpn-instance vpn-instance-name ]
undo session-based netstream export host
Default
No destination host is specified for session-based NetStream data export.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the IP address of the destination host.
udp-port: Specifies the destination UDP port number in the range of 0 to 65535.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance to which the destination host belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the destination host is on the public network, do not specify this option.
Examples
# Export session-based NetStream data to UDP port 9020 on host 172.16.1.1.
<Sysname> system-view
[Sysname] session-based netstream export host 172.16.1.1 9020
session-based netstream export source ip
Use session-based netstream export source ip to specify a source IP address for session-based NetStream packets.
Use undo session-based netstream export source ip to restore the default.
Syntax
session-based netstream export source ip ip-address
undo session-based netstream export source ip
Default
The source IP address of session-based NetStream packets is the primary IP address of the output interface.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IP address.
Examples
# Specify 172.16.1.1 as the source IP address for session-based NetStream packets.
<Sysname> system-view
[Sysname] session-based netstream export source ip 172.16.1.1
session-based netstream session-timeout
Use session-based netstream session-timeout to set the aging timer for inactive sessions.
Use undo session-based netstream session-timeout to restore the default.
Syntax
session-based netstream session-timeout seconds
undo session-based netstream session-timeout
Default
The aging timer for inactive sessions is 400 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
seconds: Sets the aging timer in seconds. The value must be an integer multiple of 200. The value range is 400 to 800.
Usage guidelines
A session is inactive if no packet for the session arrives within its aging timer.
Examples
# Set the aging timer to 600 seconds for inactive sessions.
<Sysname> system-view
[Sysname] session-based netstream session-timeout 600
session-based netstream timeout
Use session-based netstream timeout to set the aging timer for session-based NetStream entries.
Use undo session-based netstream timeout to restore the default.
Syntax
session-based netstream timeout minutes
undo session-based netstream timeout
Default
The aging timer for session-based NetStream entries is 5 minutes.
Views
System view
Predefined user roles
network-admin
Parameters
minutes: Sets the aging timer in minutes. The value range is 1 to 10.
Usage guidelines
When the aging timer for a session-based NetStream entry expires, the device clears the entry statistics and exports them to the NetStream servers.
Examples
# Set the aging timer for session-based NetStream entries to 10 minutes.
<Sysname> system-view
[Sysname] session-based netstream timeout 10