Table of Contents

Related Documents

13-IPv6 NetStream commands

Title	Size	Download
13-IPv6 NetStream commands	204.25 KB

IPv6 NetStream commands

display ipv6 netstream cache

Use display ipv6 netstream cache to display IPv6 NetStream entry information.

Syntax

display ipv6 netstream cache [ verbose ] [ type { ip | ipl2 | l2 | mpls [ label-position1 label-value1 [ label-position2 label-value2 [ label-position3 label-value3 [ label-position4 label-value4 [ label-position5 label-value5 [ label-position6 label-value6 ] ] ] ] ] ] } ] [ destination destination-ipv6 | destination-port destination-port | interface interface-type interface-number | protocol protocol | source source-ipv6 | source-port source-port ] * [ arrived-time start-date start-time end-date end-time ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information about IPv6 NetStream entries. If you do not specify this keyword, this command displays brief information about IPv6 NetStream entries.

type: Specifies the IPv6 NetStream entry type. If you do not specify this keyword, this command displays information about all types of IPv6 NetStream entries.

ip: Specifies IP flow NetStream entries.

ipl2: Specifies Layer 2 and Layer 3 flow NetStream entries.

l2: Specifies Layer 2 flow NetStream entries.

mpls: Specifies MPLS flow NetStream entries.

label-position1 label-value1: Specifies a label by its position and value. The value range for the label-position1 argument is 1 to 6, representing labels from the top label to the bottom label. The value range for the label-value1 argument is 0 to 1048575.

label-position2 label-value2: Specifies a label by its position and value. The value range for the label-position2 argument is 1 to 6, representing labels from the top label to the bottom label. Do not specify the position that has been specified. The value range for the label-value2 argument is 0 to 1048575.

label-position3 label-value3: Specifies a label by its position and value. The value range for the label-position3 argument is 1 to 6, representing labels from the top label to the bottom label. Do not specify the position that has been specified. The value range for the label-value3 argument is 0 to 1048575.

label-position4 label-value4: Specifies a label by its position and value. The value range for the label-position4 argument is 1 to 6, representing labels from the top label to the bottom label. Do not specify the position that has been specified. The value range for the label-value4 argument is 0 to 1048575.

label-position5 label-value5: Specifies a label by its position and value. The value range for the label-position5 argument is 1 to 6, representing labels from the top label to the bottom label. Do not specify the position that has been specified. The value range for the label-value5 argument is 0 to 1048575.

label-position6 label-value6: Specifies a label by its position and value. The value range for the label-position6 argument is 1 to, representing labels from the top label to the bottom label. Do not specify the position that has been specified. The value range for the label-value6 argument is 0 to 1048575.

destination destination-ipv6: Specifies a destination IPv6 address. If you specify this option, this command does not display Layer 2 flow NetStream entries.

destination-port destination-port: Specifies a destination port number in the range of 0 to 65535. 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.

protocol protocol: Specifies a protocol by its number in the range of 0 to 255 or by its name such as GRE, OSPF, TCP, or UDP. If you specify this option, this command does not display Layer 2 NetStream entries.

source source-ipv6: Specifies a source IPv6 address. If you specify this option, this command does not display Layer 2 flow NetStream entries.

source-port source-port: Specifies a source port number in the range of 0 to 65535. If you specify this option, this command does not display Layer 2 NetStream entries.

arrived-time: Specifies an arrived time range to display IPv6 NetStream entries. If you specify this keyword, make sure the end date and time is not earlier than the start date and time. If you do not specify this keyword, the arrived time is not used as a criterion for filtering the IPv6 NetStream entries to be displayed.

start-date: Specifies the start date in the format of MM/DD/YYYY or YYYY/MM/DD, where MM is in the range of 1 to 12 and YYYY is in the range of 2000 to 2035. The value range for DD varies by the value of MM.

start-time: Specifies the start time in the format of HH:MM:SS, where HH is in the range of 0 to 23, MM and SS are in the range of 0 to 59. The SS element can be omitted if its value is 00. Both the SS and MM elements can be omitted if their values are 0. For example, the start time of 0 indicates 00:00:00.

end-date: Specifies the end date in the format of MM/DD/YYYY or YYYY/MM/DD, where MM is in the range of 1 to 12 and YYYY is in the range of 2000 to 2035. The value range for DD varies by the value of MM.

end-time: Specifies the end time in the format of HH:MM:SS, where HH is in the range of 0 to 23, MM and SS are in the range of 0 to 59. The SS element can be omitted if its value is 00. Both the SS and MM elements can be omitted if their values are 0. For example, the end time of 0 indicates 00:00:00.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about IPv6 NetStream entries for all cards.

verbose: Displays detailed information about IPv6 NetStream entries.

Usage guidelines

Statistics about packets containing IP headers are classified as ipl2 (Layer 2 and Layer 3). Statistics about packets without IP headers are classified as l2 (Layer 2).

Examples

# Display detailed information about IPv6 NetStream entries.

<Sysname> display ipv6 netstream cache verbose

IPv6 NetStream cache information:

Active flow timeout : 60 min

Inactive flow timeout : 10 sec

Max number of entries : 1000

IPv6 active flow entries : 1

MPLS active flow entries : 2

IPL2 active flow entries : 1

IPv6 flow entries counted : 10

MPLS flow entries counted : 20

IPL2 flow entries counted : 20

Last statistics resetting time : 01/01/2019 at 00:01:02

IPv6 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 TC FlowLbl If(Direct) Pkts

DstMAC(VLAN) SrcMAC(VLAN)

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

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

IP 2001::1(1024) 2002::1(21) 6 0 0x6000 GE1/0/1(I) 42996

TcpFlag: 0x1b

DstMask: 24 SrcMask: 24

DstAS: 0 SrcAS: 0

NextHop: 2001::2

BGPNextHop: 0:0:0:0:0:0:0:0

InVRF: mvpn

TTE ID(Local/Remote): 0x00000000/0x00000000

SamplerMode: 0 SamplerInt: 0 VNI: 10

Active: 120 Bytes/Pkt: 152

First packet arrived: 10/28/2013, 14:10:03

Last packet arrived: 10/28/2013, 14:21:03

SrcMac: 8048-abcd-1234

DstMac: 8061-6cf6-170a

SRv6 policy NID: N/A

MPLS LDP(3.3.3.3/24) 1:18-6-0 GE1/0/2(O) 291

2:24-6-0

3:30-6-0

4:32-6-0

5:34-6-0

6:36-6-1

SamplerMode: 0 SamplerInt: 0 VNI: N/A

Active: 660 Bytes/Pkt: 100

First packet arrived: 10/28/2013, 14:10:03

Last packet arrived: 10/28/2013, 14:21:03

SrcMac: 8048-abcd-1234

DstMac: 8061-6cf6-170a

IP& 2003::1(2048) 2008::1(0) 1 0 0x0 GE1/0/2(O) 10

IP& 2010::1(1024) 2020::1(67) 17 0 0x12345 GE1/0/3(I) 1848

MPLS LDP(4.4.4.4/24) 1:55-6-0

2:16-6-1

2:0-0-0

TcpFlag: 0

DstMask: 24 SrcMask: 24

DstAS: 0 SrcAS: 0

NextHop: 2020::2

BGPNextHop: 0:0:0:0:0:0:0:0

InVRF: vpn1

SamplerMode: 0 SamplerInt: 0 VNI: N/A

Active: 382 Bytes/Pkt: 1426

First packet arrived: 10/28/2013, 14:10:03

Last packet arrived: 10/28/2013, 14:21:03

SrcMac: 8048-abcd-1234

DstMac: 8061-6cf6-170a

Table 1 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 IPv6 flows allowed in the cache.
IPv6 active flow entries	Number of active IPv6 flows in the cache.
MPLS active flow entries	Number of active IPv6 MPLS flows in the cache.
IPL2 active flow entries	Number of active Layer 2 flows with IPv6 protocol information.
IPv6 flow entries counted	Number of IPv6 flows that have been counted.
MPLS flow entries counted	Number of MPLS flows that have been counted.
IPL2 flow entries counted	Number of Layer 2 flows (with IPv6 protocol information) that have been counted.
Last statistics resetting time	Last time the reset ipv6 netstream statistics command was executed. This field displays Never if you have never executed this command.
IPv6 packet size distribution (1103746 packets in total):	Distribution of IPv6 packets by packet size, and the bracketed number is the total number of IPv6 packets. The value is displayed in the proportion of the number of IPv6 packets of the specified sizes to the total number of IPv6 packets. The value is displayed with three 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 >4608	Range of IPv6 packet length (excluding data link layer header). · For the values in the range of 1 to 576 bytes, the range increases in the step of 32 bytes. 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 bytes, the range increases in the step of 512 bytes. 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 Flow/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 TC FlowLbl If(Direct) Pkts	Statistics of the active flows in the current cache: · Flow type. Flows are classified into the following types: ¡ IP flows. ¡ Layer 2 flows with IPv6 protocol information (IPL2). ¡ MPLS flows without IP options (MPLS). ¡ MPLS flows with IP options (IP&MPLS). · Destination IPv6 address (destination port). · Source IPv6 address (source port). · Protocol number. · Traffic classification. · Flow label. · Interface name (direction). · Number of packets. ICMPv6 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 for 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	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 six labels can be listed in one label list. A label includes the following fields: · Lbl—20-bit label value. · Exp—3-bit field for implementing QoS. · S—1-bit bottom of stack flag. The S field is set to 1 if the label is the bottom label and set to 0 if not.
TcpFlag: TTL: DstMask: SrcMask: DstAS: SrcAS: NextHop: BGPNextHop: OutVRF: InVRF: SamplerMode: SamplerInt: Active: Bytes/Pkt: First packet arrived: Last packet arrived: SrcMac: DstMac:	Other information about the active flows in the cache: · TcpFlag—TCP flag. · DstMask—Destination mask. · SrcMask—Source mask. · DstAS—Destination AS. · SrcAS—Source AS. · NextHop—Routing next hop. · BGPNexthop—BGP next hop. · OutVRF—VPN to which the outbound packets belong. · InVRF—VPN to which the inbound packets belong. · TTE ID(Local/Remote)—Local/Remote tunnel endpoint ID. · SamplerMode—Sampling mode. IPv6 NetStream supports the following sampling modes: ¡ 0—No sampling. ¡ 1—Fixed sampling. ¡ 2—Random sampling. · SamplerInt—Sampling interval. · VNI—VXLAN ID. · Active—Flow's active time. · Bytes/Pkt—Number of bytes per packet. · First packet arrived—Arrival time of the first packet of the flow. · Last packet arrived—Arrival time of the last packet of the flow. · SrcMac—Source MAC address. · DstMac—Destination MAC address. ·

display ipv6 netstream cache archive

Use display ipv6 netstream cache archive to display the locally archived IPv6 NetStream entries.

Syntax

display ipv6 netstream cache archive [ verbose ] [ type { ip | ipl2 | l2 | mpls [ label-position1 label-value1 [ label-position2 label-value2 [ label-position3 label-value3 [ label-position4 label-value4 [ label-position5 label-value5 [ label-position6 label-value6 ] ] ] ] ] ] } ] [ destination destination-ip | destination-port destination-port | interface interface-type interface-number | protocol protocol | source source-ip | source-port source-port ] * [ arrived-time start-date start-time end-date end-time ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed IPv6 NetStream entry information.

type: Specifies the IPv6 NetStream entry type. If you do not specify this keyword, this commands displays information about all types of IPv6 NetStream entries.

ip: Specifies Layer 3 NetStream entries.

ipl2: Specifies Layer 2 and Layer 3 NetStream entries.

l2: Specifies Layer 2 NetStream entries.

mpls: Specifies MPLS NetStream entries.

label-position1 label-value1: Specifies a label by its position and value. The value range for the label-position1 argument is 1 to 6, representing labels from the outermost to the innermost. The value range for the label-value1 argument is 0 to 1048575.

label-position2 label-value2: Specifies a label by its position and value. The value range for the label-position2 argument is 1 to 6, representing labels from the outermost to the innermost. The value range for the label-value2 argument is 0 to 1048575.

label-position3 label-value3: Specifies a label by its position and value. The value range for the label-position3 argument is 1 to 6, representing labels from the outermost to the innermost. The value range for the label-value3 argument is 0 to 1048575.

destination destination-ipv6: Specifies a destination IPv6 address. 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-ipv6: Specifies a source IPv6 address. If you specify this option, this command does not display Layer 2 NetStream entries.

destination-port destination-port: Specifies a destination port number in the range of 0 to 65535. If you specify this option, this command does not display Layer 2 NetStream entries.

source-port source-port: Specifies a source port number in the range of 0 to 65535. If you specify this option, this command does not display Layer 2 NetStream entries.

arrived-time: Specifies an arrived time range to display NetStream entries. If you specify this keyword, make sure the end date and time is not earlier than the start date and time. If you do not specify this keyword, the arrived time is not used as a criterion for filtering the NetStream entries to be displayed.

· start-date: Specifies the start date in the format of MM/DD/YYYY or YYYY/MM/DD, where MM is in the range of 1 to 12 and YYYY is in the range of 2000 to 2035. The value range for DD varies by the value of MM.

· start-time: Specifies the start time in the format of HH:MM:SS, where HH is in the range of 0 to 23, MM and SS are in the range of 0 to 59. The SS element can be omitted if its value is 00. Both the SS and MM elements can be omitted if their values are 0. For example, the start time of 0 indicates 00:00:00.

· end-date: Specifies the end date in the format of MM/DD/YYYY or YYYY/MM/DD, where MM is in the range of 1 to 12 and YYYY is in the range of 2000 to 2035. The value range for DD varies by the value of MM.

· end-time: Specifies the end time in the format of HH:MM:SS, where HH is in the range of 0 to 23, MM and SS are in the range of 0 to 59. The SS element can be omitted if its value is 00. Both the SS and MM elements can be omitted if their values are 0. For example, the end time of 0 indicates 00:00:00.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about NetStream entries for all cards.

Examples

# Display information about the NetStream entries archived between 14:10:03 and 14:23:03 on July 28, 2017.

<Sysname> display ipv6 netstream cache archive arrived-time 7/28/2017 14:10:03 7/28/2017 14:23:03

Type DstIP(Port) SrcIP(Port) Pro TC FlowLbl APPID If(Direct) Pkts

DstMAC(VLAN) SrcMAC(VLAN)

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

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

IP 2001::1(1024) 2002::1(21) 6 0 0x6000 0x0 GE1/0/1(I) 42996

First packet arrived: 7/28/2017, 14:20:03

Last packet arrived: 7/28/2017, 14:21:03

MPLS LDP(3.3.3.3/24) 1:18-6-0 12 0 0x12345 0x0 GE1/0/2(O) 291

2:24-6-0

3:30-6-1

First packet arrived: 7/28/2017, 14:20:01

Last packet arrived: 7/28/2017, 14:21:03

See Table 1 for the command output description.

Related commands

ip netstream cache archive enable

display ipv6 netstream export

Use display ipv6 netstream export to display information about the IPv6 NetStream data export.

Syntax

display ipv6 netstream export

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

IP NetStream export information varies by aggregation mode. This command displays IPv6 NetStream export information for all the configured aggregation modes.

Examples

# Display information about the IPv6 NetStream data export.

<Sysname> display ipv6 netstream export

protocol-port aggregation export information:

Flow source interface : GigabitEthernet1/0/1

Flow destination VPN instance : VPN1

Flow destination IPv6 address (UDP) : 40::1 (30000)

Version 9 exported flow number : 16

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

Version 10 exported flow number : 0

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

IPv6 export information:

Flow source interface : GigabitEthernet1/0/1

Flow destination VPN instance : VPN1

Flow destination IPv6 address (UDP) : 40::1 (30000)

Version 9 exported flow number : 16

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

Version 10 exported flow number : 0

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

MPLS export information:

Flow source interface : GigabitEthernet1/0/1

Flow destination VPN instance : VPN1

Flow destination IPv6 address (UDP) : 40::1 (30000)

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 2 Command output

Field	Description
protocol-port aggregation export information	Statistics of IPv6 NetStream protocol-port aggregation in the version 9 format.
IPv6 export information	Information about the IPv6 NetStream data export.
Flow source interface	Source interface from which the IPv6 NetStream data is exported.
Flow destination VPN instance	VPN to which the destination address of the IPv6 NetStream data export belongs.
Flow destination IPv6 address (UDP)	Destination IPv6 address and UDP port number of the IPv6 NetStream data export.
Version 9 exported flow number	Number of flows that are exported in the version 9 format.
Version 9 exported UDP datagram number (failed)	Number of UDP packets that are sent in the version 9 format. The value in the parentheses displays the number of UDP packets that failed to be sent.
Version 10 exported flow number	Number of flows that are exported in the version 10 format.
Version 10 exported UDP datagram number (failed)	Number of UDP packets that are sent in the version 10 format. The value in the parentheses displays the number of UDP packets that failed to be sent.
MPLS export information	Statistics of the MPLS-aware IPv6 NetStream data export in version 9.

‌

display ipv6 netstream template

Use display ipv6 netstream template to display IPv6 NetStream template information.

Syntax

display ipv6 netstream template [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command displays IPv6 NetStream template information for the active MPU.

Usage guidelines

IPv6 NetStream templates vary by aggregation mode. This command displays IPv6 NetStream template information for all the configured aggregation modes.

Examples

# Display IPv6 NetStream template information.

<Sysname> display ipv6 netstream template

Flow template refresh frequency : 20

Flow template refresh interval : 30 min

Active flow templates : 2

Created flow templates : 2

Protocol-port outbound template:

Template ID : 3258

Field count : 15

Field type Field length (bytes)

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

Flows 4

Out packets 8

Out bytes 8

First forwarded 4

Last forwarded 4

Protocol 1

IP protocol version 1

Direction 1

PAD 1

L4 source port 2

L4 destination port 2

Sampling algorithm 1

PAD 1

Sampling interval 4

Local TTE ID 4

Remote TTE ID 4

Serial number 65535

Protocol-port inbound template:

Template ID : 3257

Field count : 15

Field type Field length (bytes)

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

Flows 4

In packets 8

In bytes 8

First forwarded 4

Last forwarded 4

Protocol 1

IP protocol version 1

Direction 1

PAD 1

L4 source port 2

L4 destination port 2

Sampling algorithm 1

PAD 1

Sampling interval 4

Local TTE ID 4

Remote TTE ID 4

Serial number 65535

Table 3 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 IPv6 NetStream templates.
Created flow templates	Number of templates that have been created.
Protocol-port outbound template	Information about the protocol-port template in the outbound direction.
Protocol-port inbound template	Information about the protocol-port template in the inbound direction.
Field count	Total number of fields in the template.
Field type	Type of a field in the template.
Flows	Number of flows.
Out packets	Number of sent packets.
In packets	Number of received packets.
Out bytes	Number of sent bytes.
In bytes	Number of received 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.
Direction	Traffic direction.
L4 source port	Source UDP or TCP port.
L4 destination port	Destination UDP or TCP port.
Sampling algorithm	Sampling algorithm.
PAD	Padding string.
Sampling interval	Sampling rate.
Local TTE ID	Local tunnel endpoint ID. This field is supported only by version 9.
Remote TTE ID	Remote tunnel endpoint ID. This field is supported only by version 9.
Serial number	Device serial number.

enable

Use enable to enable an IPv6 NetStream aggregation mode.

Use undo enable to disable an IPv6 NetStream aggregation mode.

Syntax

enable

undo enable

Default

No IPv6 NetStream aggregation mode is enabled.

Views

IPv6 NetStream aggregation mode view

Predefined user roles

network-admin

Examples

# Enable IPv6 NetStream destination-prefix aggregation mode.

<Sysname> system-view

[Sysname] ipv6 netstream aggregation destination-prefix

[Sysname-ns6-aggregation-dstpre] enable

Related commands

ipv6 netstream aggregation

ipv6 netstream

Use ipv6 netstream to enable IPv6 NetStream on an interface.

Use undo ipv6 netstream to disable IPv6 NetStream on an interface.

Syntax

ipv6 netstream { inbound | outbound }

undo ipv6 netstream { inbound | outbound }

Default

IPv6 NetStream is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

inbound: Enables IPv6 NetStream for incoming traffic.

outbound: Enables IPv6 NetStream for outgoing traffic.

Examples

# Enable IPv6 NetStream for inbound traffic on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 netstream inbound

ipv6 netstream aggregation

Use ipv6 netstream aggregation to specify an IPv6 NetStream aggregation mode and enter its view.

Use undo ipv6 netstream aggregation to remove the configuration for an IPv6 NetStream aggregation mode.

Syntax

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

undo ipv6 netstream aggregation { as | bgp-nexthop | destination-prefix | prefix | protocol-port | source-prefix }

Default

No IPv6 NetStream aggregation mode is specified.

Views

System view

Predefined user roles

network-admin

Parameters

as: Specifies the AS aggregation by source AS number, destination AS number, input interface index, and output interface index.

bgp-nexthop: Specifies the BGP nexthop aggregation by BGP next hop IPv6 address and output interface index.

destination-prefix: Specifies the destination-prefix aggregation by destination AS number, destination address mask length, destination prefix, and output interface index.

prefix: Specifies the source and destination prefix aggregation by the following criteria:

· Source AS number.

· Destination AS number.

· Source address mask length.

· Destination address mask length.

· Source prefix.

· Destination prefix.

· Input interface index.

· Output interface index.

protocol-port: Specifies the protocol-port aggregation by protocol number, source port, and destination port.

source-prefix: Specifies the source-prefix aggregation by source AS number, source address mask length, source prefix, and input interface index.

Usage guidelines

In IPv6 NetStream aggregation mode view, you can perform the following tasks:

· Enable or disable the specified IPv6 NetStream aggregation mode.

· Configure source interface, destination IPv6 address, and destination port for the IPv6 NetStream data export.

A flow matching multiple aggregation modes is counted as multiple aggregate flows.

Examples

# Set the IPv6 NetStream aggregation mode to destination-prefix, and enter IPv6 NetStream destination-prefix aggregation mode view.

<Sysname> system-view

[Sysname] ipv6 netstream aggregation destination-prefix

[Sysname-ns6-aggregation-dstpre]

Related commands

enable

ipv6 netstream export host

ipv6 netstream export source

ipv6 netstream cache archive enable

Use ipv6 netstream cache archive enable to enable archiving of cached IPv6 NetStream entries.

Use undo ipv6 netstream cache archive enable to disable archiving of cached IPv6 NetStream entries.

Syntax

ipv6 netstream cache archive enable

undo ipv6 netstream cache archive enable

Default

Archiving of cached IPv6 NetStream entries is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This feature enables local archiving of cached IPv6 NetStream entries when they are exported to NetStream servers.

You can display the locally archived IPv6 NetStream entries by using the display ipv6 netstream cache archive command.

This feature is applicable when a small number of IPv6 NetStream entries exist and no log server exists. If the device generates a large number of IPv6 NetStream entries, do not enable this feature. Otherwise, the device performance will be affected.

Examples

# Enable archiving of cached IPv6 NetStream entries.

<Sysname> system-view

[Sysname] ipv6 netstream cache archive enable

Related commands

display ipv6 netstream cache archive

ipv6 netstream export host

Use ipv6 netstream export host to specify a destination host for IPv6 NetStream data export.

Use undo ipv6 netstream export host to remove the specified destination host or all destination hosts that are configured in the current view.

Syntax

ipv6 netstream export host { ipv4-address | ipv6-address } udp-port [ vpn-instance vpn-instance-name ]

undo ipv6 netstream export host [ ipv4-address | ipv6-address ] [ vpn-instance vpn-instance-name ]

Default

No destination host is specified for IPv6 NetStream data export.

Views

System view

IPv6 NetStream aggregation mode view

Predefined user roles

network-admin

Parameters

ipv4-address: Specifies the destination IPv4 address.

ipv6-address: Specifies the destination IPv6 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 the same destination host address and UDP port in different IPv6 NetStream aggregation mode views. If an aggregation mode is not enabled, the display ipv6 netstream export command cannot display the destination host configuration for the mode.

If no destination host is specified in an IPv6 NetStream aggregation mode view, the destination host in system view applies. If destination hosts are specified in an IPv6 NetStream aggregation view and system view, the destination hosts in aggregation view take effect.

In system view or in IPv6 NetStream aggregation mode view, you can specify a maximum of four IPv4 destination hosts and four IPv6 destination hosts, respectively. If you specify a destination host with the same destination address but different UDP ports in the same view, the most recent configuration takes effect. You can specify destination hosts with the same destination address and UDP port but different VPN instances.

IPv6 NetStream traditional data is exported to all destination hosts in system view. IPv6 NetStream aggregation data is exported to all destination hosts in the related aggregation view. If you expect only IPv6 NetStream aggregation data, specify destination hosts only in the IPv6 NetStream aggregation mode view. Aggregation data export reduces bandwidth usage.

Examples

# In system view, specify 40::1 as the IP address of the destination host and UDP port 5000 as the export destination port number.

<Sysname> system-view

[Sysname] ipv6 netstream export host 40::1 5000

Related commands

ipv6 netstream aggregation

ipv6 netstream export source

ipv6 netstream export rate

Use ipv6 netstream export rate to limit the IPv6 NetStream data export rate.

Use undo ipv6 netstream export rate to restore the default.

Syntax

ipv6 netstream export rate rate

undo ipv6 netstream export rate

Default

The export rate of IPv6 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 IPv6 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] ipv6 netstream export rate 10

ipv6 netstream export source

Use ipv6 netstream export source to specify the source interface for data packets sent to NetStream servers. The IPv6 address of the interface is used as the source IPv6 address of the data packets.

Use undo ipv6 netstream export source to restore the default.

Syntax

ipv6 netstream export source interface interface-type interface-number

undo ipv6 netstream export source

Default

The packets take the IPv6 address of the output interface as the source IPv6 address.

Views

System view

IPv6 NetStream aggregation mode view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies a source interface by its type and number for the IPv6 NetStream data export.

Usage guidelines

You can configure different source interfaces in different IPv6 NetStream aggregation mode views.

If no source interface is configured in IPv6 NetStream aggregation mode view, the source interface in system view applies.

As a best practice, connect the management Ethernet interface to a NetStream server, and configure the interface as the source interface.

Examples

# In system view, specify GigabitEthernet 1/0/1 as the source interface for IPv6 NetStream traditional data packets.

<Sysname> system-view

[Sysname] ipv6 netstream export source interface gigabitethernet 1/0/1

# In destination-prefix aggregation mode view, specify GigabitEthernet 1/0/2 as the source interface for IPv6 NetStream aggregation data packets.

<Sysname> system-view

[Sysname] ipv6 netstream aggregation destination-prefix

[Sysname-ns6-aggregation-dstpre] ipv6 netstream export source interface gigabitethernet 1/0/2

Related commands

ipv6 netstream aggregation

ipv6 netstream export template refresh-rate

Use ipv6 netstream export template refresh-rate to set the refresh rate for the IPv6 NetStream version 9 or version 10 template.

Use undo ipv6 netstream export template refresh-rate to restore the default.

Syntax

ipv6 netstream export template refresh-rate { packet packets | time minutes }

undo ipv6 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

packet 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. An IPv6 NetStream device must send the version 9 or version 10 template to NetStream servers regularly, because the servers do not permanently save 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 IPv6 NetStream version 9 or version 10 template every 100 packets.

<Sysname> system-view

[Sysname] ipv6 netstream export template refresh-rate packet 100

ipv6 netstream export version

Use ipv6 netstream export version 9 to export IPv6 NetStream data in the version 9 format and choose whether to record AS, BGP next hop, and serial number information.

Use ipv6 netstream export version 10 to export IPv6 NetStream data in the version 10 format and choose whether to record AS, BGP next hop, and serial number information.

Use undo ipv6 netstream export version to restore the default.

Syntax

ipv6 netstream export version { 9 | 10 } { origin-as | peer-as } [ bgp-nexthop ] [ serial-number ]

undo ipv6 netstream export version

Default

The version 9 format is used to export IPv6 NetStream data.

The peer AS numbers are recorded. The BGP next hop and serial number are 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.

serial-number: Records device serial numbers.

Usage guidelines

Only one version format can take effect on the device. If you execute the ipv6 netstream export version command multiple times, the most recent configuration takes effect.

An IPv6 NetStream entry records the source IPv6 address, destination IPv6 address, and two AS numbers for each address. You can choose to configure which AS numbers are to be exported as the source AS and destination AS.

In version 9 and version 10 formats, you can also choose whether to record the BGP next hop and serial number information.

Examples

# Configure the device to export IPv6 NetStream data in the version 9 format, specify the IPv6 NetStream data to include the source AS and destination AS, and record BGP next hop and serial number attributes.

<Sysname> system-view

[Sysname] ipv6 netstream export version 9 origin-as bgp-nexthop serial-number

ipv6 netstream filter

Use ipv6 netstream filter to enable IPv6 NetStream filtering on an interface.

Use undo ipv6 netstream filter to disable IPv6 NetStream filtering on an interface.

Syntax

ipv6 netstream { inbound | outbound } filter acl acl-number

undo ipv6 netstream { inbound | outbound } filter

Default

IPv6 NetStream filtering is disabled. IPv6 NetStream collects statistics about all IPv6 packets passing through an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

inbound: Filters incoming traffic.

outbound: Filters outgoing traffic.

acl acl-number: Specifies an IPv6 ACL by its number. The value range is 2000 to 2999 for basic ACLs and 3000 to 3999 for advanced ACLs.

Usage guidelines

IPv6 NetStream filtering uses an ACL to identify intended packets.

· If you want to collect data for specific flows, use the ACL permit statements to identify the flows. IPv6 NetStream collects data only for these flows.

· If you do not want to collect data for specific flows, use the ACL deny statements to identify the flows. IPv6 NetStream does not collect data for these flows.

When you use an ACL, follow these guidelines:

· If you use a non-existent ACL or no rule is configured in the ACL, IPv6 NetStream collects data for all inbound and outbound flows on the interface.

· The support of ACL rules for the vpn-instance parameter and the effect of the parameter vary by the device model.

Examples

# Use ACL 2003 for outbound IPv6 NetStream filtering on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 netstream outbound

[Sysname-GigabitEthernet1/0/1] ipv6 netstream outbound filter acl 2003

ipv6 netstream max-entry

Use ipv6 netstream max-entry to set the upper limit for IPv6 NetStream entries or specify the processing method when the upper limit is reached.

Use undo ipv6 netstream max-entry to restore the default.

Syntax

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

undo ipv6 netstream max-entry

Default

When the number of IPv6 NetStream entries in the cache reaches the upper limit, the system disables creation of a new entry.

Views

System view

Predefined user roles

network-admin

Parameters

max-entries: Specifies the upper limit for IPv6 NetStream entries that the cache can accommodate.

The following compatibility matrix shows the value ranges for the upper limit for IPv6 NetStream entries that the cache can accommodate:

MPU model	Value range
MSU-100	1000 to 50000
MSU-200	1000 to 50000
MSU-400-G	1000 to 2000000

‌

aging: Ages out the oldest entries when the upper limit is reached.

disable-caching: Disables creation of a new entry when the upper limit is reached.

Usage guidelines

The max-entries argument takes effect on each card.

If you execute the ipv6 netstream max-entry max-entries command multiple times, the most recent configuration takes effect.

If you execute the ipv6 netstream max-entry { aging | disable-caching } command multiple times, the most recent configuration takes effect.

Examples

# Set the upper limit to 5000 for IPv6 NetStream entries.

<Sysname> system-view

[Sysname] ipv6 netstream max-entry 5000

# Disable creation of a new entry when the upper limit is reached.

<Sysname> system-view

[Sysname] ipv6 netstream max-entry disable-caching

# Configure the device to age out the oldest entries when the upper limit is reached.

<Sysname> system-view

[Sysname] ipv6 netstream max-entry aging

ipv6 netstream sampler

Use ipv6 netstream sampler to enable IPv6 NetStream sampling.

Use undo ipv6 netstream sampler to disable IPv6 NetStream sampling.

Syntax

ipv6 netstream [ inbound | outbound ] sampler sampler-name

undo ipv6 netstream [ inbound | outbound ] sampler

Default

IPv6 NetStream sampling is disabled.

Views

Interface view

Predefined user roles

network-admin

Parameters

inbound: Enables IPv6 NetStream sampling in the inbound direction.

outbound: Enables IPv6 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

IPv6 NetStream sampling allows you to collect basically accurate network statistics and decrease the IPv6 NetStream traffic volume. The decreased traffic lessens the impact on the device forwarding performance. The higher the sampling rate, the less impact on device performance.

If you configure this command without specifying a traffic direction, IPv6 NetStream sampling is enabled on the interface for both inbound and outbound traffic.

Examples

# Use sampler abc for inbound IPv6 NetStream sampling on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 netstream inbound

[Sysname-GigabitEthernet1/0/1] ipv6 netstream inbound sampler abc

ipv6 netstream timeout active

Use ipv6 netstream timeout active to set the aging timer for active flows.

Use undo ipv6 netstream timeout active to restore the default.

Syntax

ipv6 netstream timeout active minutes

undo ipv6 netstream timeout active

Default

The aging timer is 30 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 IPv6 NetStream entry arrive before the timer set by this command expires.

Examples

# Set the aging timer to 4 minutes for active flows.

<Sysname> system-view

[Sysname] ipv6 netstream timeout active 4

Related commands

ipv6 netstream timeout inactive

Use ipv6 netstream timeout inactive to set the aging timer for inactive flows.

Use undo ipv6 netstream timeout inactive to restore the default.

Syntax

ipv6 netstream timeout inactive seconds

undo ipv6 netstream timeout inactive

Default

The aging timer is 30 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 600 seconds.

Usage guidelines

A flow is considered inactive if no packet for the IPv6 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] ipv6 netstream timeout inactive 60

Related commands

ipv6 netstream timeout active

reset ipv6 netstream statistics

Use reset ipv6 netstream statistics to age out all flows in the cache and export IPv6 NetStream data.

Syntax

reset ipv6 netstream statistics

Views

User view

Predefined user roles

network-admin

Usage guide

It takes the system several minutes to execute the command. During this period, the system does not collect IPv6 NetStream data.

Examples

# Age out and export all IPv6 NetStream data.

<Sysname> reset ipv6 netstream statistics

This process may take a few minutes.

NetStream statistic function is disabled during this process.

snmp-agent trap enable ipv6 netstream

Use snmp-agent trap enable ipv6 netstream to enable SNMP notifications for IPv6 NetStream.

Use undo snmp-agent trap enable ipv6 netstream to disable SNMP notifications for IPv6 NetStream.

Syntax

snmp-agent trap enable ipv6 netstream [ entry-limit ]

undo snmp-agent trap enable ipv6 netstream [ entry-limit ]

Default

SNMP notifications are enabled for IPv6 NetStream.

Views

System view

Predefined user roles

network-admin

Parameters

entry-limit: Generates an alarm when the number of cached IPv6 NetStream entries exceeds 80% or drops below 70% of the maximum permitted value. If you do not specify this keyword, the system enables or disables all SNMP notifications for IPv6 NetStream.

Usage guidelines

To configure the maximum supported number of cached IPv6 NetStream entries, enter system view and execute the ipv6 netstream max-entry command.

Use this feature to report important events for IPv6 NetStream through SNMP notifications. The generated alarm information will be sent to the SNMP module on the device and you can configure the SNMP notification sending parameters to determine the export attributes of the alarm information. For more information, see "Configuring SNMP."

Examples

# Enable SNMP notifications for IPv6 NetStream.

<Sysname> system-view

[Sysname] snmp-agent trap enable ipv6 netstream

Related commands

ipv6 netstream max-entry

21-Network Management and Monitoring Command Reference

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us