IPv6 NetStream commands -- display ipv6 netstream cache

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

Syntax

Centralized devices:

display ipv6 netstream cache [ verbose ] [ type { ip | ipl2 | l2 | mpls [ label-position1 label-value1 [ label-position2 label-value2 [ label-position3 label-value3 ] ] ] } ] [ destination destination-ipv6 | interface interface-type interface-number | source source-ipv6 ] *

Distributed devices in standalone mode:Centralized IRF devices:

display ipv6 netstream cache [ verbose ] [ type { ip | ipl2 | l2 | mpls [ label-position1 label-value1 [ label-position2 label-value2 [ label-position3 label-value3 ] ] ] } ] [ destination destination-ipv6 | interface interface-type interface-number | source source-ipv6 ] * [ slot slot-number [ cpu cpu-number ] ]

Distributed devices in IRF mode:

display ipv6 netstream cache [ verbose ] [ type { ip | ipl2 | l2 | mpls [ label-position1 label-value1 [ label-position2 label-value2 [ label-position3 label-value3 ] ] ] } ] [ destination destination-ipv6 | interface interface-type interface-number | source source-ipv6 ] * [ chassis chassis-number slot slot-number [ cpu cpu -number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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 innermost to the outermost. 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 innermost to the outermost. 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 innermost to the outermost. 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 flow 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 flow NetStream entries.

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. (Distributed devices in standalone mode.)

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 IPv6 NetStream entries for all member devices. (Centralized IRF devices.) (IRF 3 incapable.)

slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. On an IRF fabric, this command displays information about IPv6 NetStream entries for all member devices if you do not specify a member device. On an IRF 3 system, this command displays information about IPv6 NetStream entries for all IRF member devices and PEXs if you do not specify an IRF member device or PEX. (Centralized IRF devices.) (IRF 3 capable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about IPv6 NetStream entries for all cards. (Distributed devices in IRF mode.) (IRF 3 incapable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. On an IRF fabric, this command displays information about IPv6 NetStream entries for all cards if you do not specify a card. On an IRF 3 system, this command displays information about IPv6 NetStream entries for all cards and PEXs if you do not specify a card or PEX. (Distributed devices in IRF mode.) (IRF 3 capable.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

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 information about IPv6 NetStream entries. (Applicable to routers.)

<Sysname> display ipv6 netstream cache

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/2000 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

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

2:24-6-0

3:30-6-1

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

# Display information about IPv6 NetStream entries. (Applicable to switches.)

<Sysname> display ipv6 netstream cache

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/2000 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 Vlan1(I) 42996

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

2:24-6-0

3:30-6-1

IP& 2003::1(2048) 2008::1(0) 1 0 0x0 Vlan2(O) 10

IP& 2010::1(1024) 2020::1(67) 17 0 0x12345 Vlan3(I) 1848

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

2:16-6-1

2:0-0-0

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 (1103746packets 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: ?span style='font:7.0pt "Times New Roman"'> IP flows. ?span style='font:7.0pt "Times New Roman"'> Layer 2 flows with IPv6 protocol information (IPL2). ?span style='font:7.0pt "Times New Roman"'> MPLS flows without IP options (MPLS). ?span style='font:7.0pt "Times New Roman"'> 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. · Destination VLAN ID. · Source MAC address. · Source VLAN ID.
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: ?span style='font:7.0pt "Times New Roman"'> IP address associated with the label. ?span style='font:7.0pt "Times New Roman"'> Mask associated with the label. · Label list: ?span style='font:7.0pt "Times New Roman"'> Lbl—20-bit label value. ?span style='font:7.0pt "Times New Roman"'> Exp—3-bit field for implementing QoS. ?span style='font:7.0pt "Times New Roman"'> 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: DstMask: SrcMask: DstAS: SrcAS: NextHop: BGPNextHop: OutVRF: InVRF: SamplerMode: SamplerInt: Active: Bytes/Pkt: | Other information about the active flows in the cache: · TCP flag. · Destination mask. · Source mask. · Destination AS. · Source AS. · Routing next hop. · BGP next hop. · VPN to which the outbound packets belong. · VPN to which the inbound packets belong. · Sampling mode. IPv6 NetStream supports the following sampling modes: ?span style='font:7.0pt "Times New Roman"'> 0—No sampling. ?span style='font:7.0pt "Times New Roman"'> 1—Fixed sampling. ?span style='font:7.0pt "Times New Roman"'> 2—Random sampling. · Sampling interval. · Flow's active time. · Number of bytes per packet.

IPv6 NetStream commands -- 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

mdc-admin

mdc-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. (Applicable to routers.)

<Sysname> display ipv6 netstream export

protocol-port aggregation export information:

Flow source interface : GigabitEthernet1/0/1

Flow destination VPN instance : VPN1

Flow destination IP 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 IP 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 IP 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)

# Display information about the IPv6 NetStream data export. (Applicable to switches.)

<Sysname> display ipv6 netstream export

protocol-port aggregation export information:

Flow source interface : Vlan-interface2

Flow destination VPN instance : Not specified

Flow destination IP 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 : Vlan-interface2

Flow destination VPN instance : Not specified

Flow destination IP 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 : Vlan-interface2

Flow destination VPN instance : Not specified

Flow destination IP 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 IP address (UDP) | Destination IP 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.

IPv6 NetStream commands -- display ipv6 netstream template

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

Syntax

Centralized devices:

display ipv6 netstream template

Distributed devices in standalone mode:Centralized IRF devices:

display ipv6 netstream template [ slot slot-number [ cpu cpu-number ] ]

Distributed devices in IRF mode:

display ipv6 netstream template [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays IPv6 NetStream template information for the master device. (Centralized IRF devices.) (IRF 3 incapable.)

slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify a member device or PEX, this command displays IPv6 NetStream template information for the master device. (Centralized IRF devices.) (IRF 3 capable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 NetStream template information for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 incapable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. If you do not specify a card or PEX, this command displays IPv6 NetStream template information for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 capable.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

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 : 14

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

PAD 1

PAD 1

Sampling interval 4

Protocol-port inbound template:

Template ID : 3257

Field count : 14

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

PAD 1

PAD 1

Sampling interval 4

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.

IPv6 NetStream commands -- 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

mdc-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 commands -- ipv6 netstream (interface view)

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

mdc-admin

Parameters

inbound: Enables IPv6 NetStream for incoming traffic.

outbound: Enables IPv6 NetStream for outgoing traffic.

Usage guidelines

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

Examples

# Enable IPv6 NetStream for incoming traffic on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

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

# Enable NetStream for incoming traffic on VLAN-interface 1. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ipv6 netstream inbound

IPv6 NetStream commands -- ipv6 netstream (system view)

Use ipv6 netstream to enable IPv6 NetStream globally.

Use undo ipv6 netstream to disable IPv6 NetStream globally.

Syntax

ipv6 netstream

undo ipv6 netstream

Default

IPv6 NetStream is disabled globally.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

After you enable IPv6 NetStream globally, IPv6 NetStream is enabled on all interfaces for both incoming and outgoing traffic.

Examples

# Enable IPv6 NetStream globally.

<Sysname> system-view

[Sysname] ipv6 netstream

IPv6 NetStream commands -- 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

mdc-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 commands -- ipv6 netstream aggregation advanced

Use ipv6 netstream aggregation advanced to enable IPv6 NetStream hardware aggregation.

Use undo ipv6 netstream aggregation advanced to disable NetStream hardware aggregation..

Syntax

ipv6 netstream aggregation advanced

undo ipv6 netstream aggregation advanced

Default

IPv6 NetStream hardware aggregation is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

The IPv6 NetStream hardware aggregation does not take effect if the destination host is configured for NetStream traditional data export.

The IPv6 NetStream hardware aggregation entries are stored in the same cache as IPv6 NetStream traditional data entries and are exportable.

Examples

# Enable the IPv6 NetStream hardware aggregation.

<Sysname> system-view

[Sysname] ipv6 netstream aggregation advanced

Related commands

ipv6 netstream export host

ipv6 netstream aggregation

IPv6 NetStream commands -- 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.

Views

System view

IPv6 NetStream aggregation mode view

Predefined user roles

network-admin

mdc-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 commands -- 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

mdc-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 commands -- 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

mdc-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 commands -- 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

mdc-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 commands -- 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 and BGP next hop information.

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

Use undo ipv6 netstream export version to restore the default.

Syntax

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

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 is not recorded.

Views

System view

Predefined user roles

network-admin

mdc-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

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 information.

Examples

# Configure the device to export IPv6 NetStream data in the version 9 format, and specify the IPv6 NetStream data to include the source AS and destination AS.

<Sysname> system-view

[Sysname] ipv6 netstream export version 9 origin-as

IPv6 NetStream commands -- 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 ipv6-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

mdc-admin

Parameters

inbound: Filters incoming traffic.

outbound: Filters outgoing traffic.

acl ipv6-acl-number: Specifies an IPv6 ACL by its number. The value range is 2000 to 2999 for basic ACLs, 3000 to 3999 for advanced ACLs, and 4000 to 4999 for Layer 2 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.

Examples

# Use ACL 2003 for outbound IPv6 NetStream filtering on GigabitEthernet 1/0/1. (Applicable to routers.)

<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

# Use ACL 2003 for outbound IPv6 NetStream filtering on VLAN-interface 1. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ipv6 netstream outbound

[Sysname-Vlan-interface1] ipv6 netstream outbound filter acl 2003

IPv6 NetStream commands -- 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

The upper limit for IPv6 NetStream entries and the processing method when the upper limit is reached vary by device model.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

max-entries: Specifies the upper limit for IPv6 NetStream entries that the cache can accommodate. The value range for this argument varies by device model.

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

(Distributed devices in standalone mode.) (Distributed devices in IRF mode.) The max-entries argument takes effect on each card.

(Centralized IRF devices.) The max-entries argument takes effect on each IRF member device.

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 commands -- 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

mdc-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

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. (Applicable to routers.)

<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

# Use sampler abc for inbound IPv6 NetStream sampling on VLAN-interface 1. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] ipv6 netstream inbound

[Sysname-Vlan-interface1] ipv6 netstream inbound sampler abc

IPv6 NetStream commands -- 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

mdc-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 5 minutes for active flows.

<Sysname> system-view

[Sysname] ipv6 netstream timeout active 5

Related commands

ipv6 netstream timeout inactive

IPv6 NetStream 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

mdc-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

IPv6 NetStream commands -- 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

mdc-admin

Usage guidelines

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.