06-IPv6 NetStream Commands
Chapters Download (63.89 KB)
Table of Contents
1 IPv6 NetStream Configuration Commands·
IPv6 NetStream Configuration Commands
display ipv6 netstream template
ipv6 netstream aggregation advanced
ipv6 netstream export v9-template refresh-rate packet
ipv6 netstream export v9-template refresh-rate time
ipv6 netstream export version 9
reset ipv6 netstream statistics
Syntax
display ipv6 netstream cache [ verbose ] [ slot slot-number ]
View
Any view
Default Level
1: Monitor level
Parameters
verbose: Displays the detailed information of the IPv6 NetStream entries in the cache.
slot slot-number: Displays the IPv6 NetStream entry information in the cache of the specified device. If the device is in an IRF, the slot-number argument represents the member ID of the device; if the device is not in any IRF, the slot-number argument represents the device ID
Description
Use the display ipv6 netstream cache command to display the IPv6 NetStream entry information in the cache.
Examples
# Display the IPv6 NetStream entry information in the cache.
<Sysname> display ipv6 netstream cache
IPv6 netstream cache information:
Stream active timeout (in minutes) : 5
Stream inactive timeout (in seconds): 100
Stream max entry number : 20470
IPv6 active stream entry number : 6
IPv6 stream entry been counted : 6
Last statistics reset time : 09/03/2009, 17:12:00
IPv6 packet size distribution (0 total packets):
1-32 64 96 128 160 192 224 256 288 320 352 384 416 448 480
.000 .000 .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 .000 .000 .000 .000 .000 .000 .000 .000 .000 .000
Protocol Total Packets Stream Packets Active(sec) Idle(sec)
Streams /Sec /Sec /stream /stream /stream
---------------------------------------------------------------------------
TCP-other 6 0 0 1 7 56
Type DstIP(Port) SrcIP(Port) Pro TC FlowLbl If(Direc) Pkts
DstMAC(VLAN) SrcMAC(VLAN)
TopLblType(IP/MASK)Lbl-Exp-S-List
---------------------------------------------------------------------------
IP 2001:301::1:0:1(1- 2001:101::1:0:1(1- 6 0 0x0 GE3/0/13(I) 1
025) 024)
IP 3000::1(1025) ::198.19.1.2(1024) 17 0 0x0 GE3/0/13(I) 3
IP 2001:301::3:0:1(1- 2001:101::3:0:1(1- 6 0 0x0 GE3/0/13(I) 1
025) 024)
IP 2001:301::2:0:1(1- 2001:101::2:0:1(1- 6 0 0x0 GE3/0/13(I) 1
025) 024)
IP 3000::1(1025) ::198.19.1.2(1024) 17 0 0x0 GE3/0/17(O) 2
IP 2001:301::2:0:1(1- 2001:101::2:0:1(1- 6 0 0x0 GE3/0/17(O) 1
025) 024)
Table 1-1 display ipv6 netstream cache command output description
|
Field |
Description |
|
IPv6 netstream cache information |
Information of IPv6 NetStream entries in the cache |
|
Stream active timeout (in minutes) |
Active aging timer for IPv6 NetStream entries |
|
Stream inactive timeout (in seconds) |
Inactive aging timer for IPv6 NetStream entries |
|
Stream max entry number |
Maximum number of flow entries allowed in the cache |
|
IPv6 active stream entry number |
Number of active IPv6 flows |
|
IPv6 stream entry been counted |
Number of IPv6 flows that are counted |
|
Last statistics reset time |
This field is an absolute time and will not change with the system time. This field is displayed only when the reset ipv6 netstream statistics command is executed; otherwise, the value for this field is Never. |
|
IPv6 packet size distribution (0 total packets): |
Number of IPv6 flows differentiated by packet size The value is displayed in the proportion of number of IP headers to the total IP packets, and is displayed with 3 decimal places. |
|
1-32 64 96 128 160 192 224 256 288 320 352 384 416 448 480 512 544 576 1024 1536 2048 2560 3072 3584 4096 4608>4608 |
Range of IP packet length (excluding data link layer header), in bytes. If the packet size does not exceed 576 bytes, the range increments in the step of 32 bytes. For example, "1-32" means number of packets in size of 1 to 32 bytes, and "64" means number of packets in size of 33 to 64 bytes. If the packet size exceeds 1024 bytes, the range increments in the step of 512 bytes. For example, "1536" means number of packets in size of 1025 to 1536 bytes. Packets in size of 577 to 1024 are recorded in the 1024 entry. |
|
Protocol Total Streams Packets /Sec Stream/Sec Packets/stream Active(sec)/stream Idle(sec)/stream |
Packet statistics differentiated by protocol type: protocol, total number of flows, number of packets per second, number of flows per second, active time for each stream, inactive time for each stream |
|
Type DstIP(Port) SrcIP(Port) Pro TC FlowLbl If(Direc) Pkts |
Statistics of the active flows in the current NetStream cache including stream type, destination IPv6 address (destination port), source IPv6 address (source port), protocol, traffic class, flow label, interface name (direction), and number of packets Where flows are classified into two types: IP flows, and L2 flows |
|
DstMAC(VLAN) SrcMAC(VLAN) |
Layer 2 information of the active flows in the current cache, including destination MAC address, destination VLAN ID, source MAC address, and source VLAN ID |
|
TopLblType(IP/MASK) Lbl-Exp-S-List |
Information of the active MPLS flows in the current cache, including type of the labels at the top of the label stack (IP address and mask associated with the label), and label list. A label consists of three fields: l Label field, label value of 20 bits. l Exp field, for QoS, three bits in length. l S field, where 1 indicates that the label is at the bottom of the label stack. |
Syntax
display ipv6 netstream export
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display ipv6 netstream export command to view statistics about IPv6 NetStream data export.
Examples
# Display statistics about IPv6 NetStream data export.
<Sysname> display ipv6 netstream export
IPv6 export information:
Stream source interface : Vlan-interface1001
Stream destination VPN-instance :
Stream destination IP (UDP) : 121.1.1.7 (9991)
Version 9 exported stream number : 6
Version 9 exported UDP datagram number (failed): 6 (6)
source-prefix aggreagtion export information:
Stream source interface : Vlan-interface1001
Stream destination VPN-instance :
Stream destination IP (UDP) : 121.1.1.7 (9991)
Version 9 exported stream number : 6
Version 9 exported UDP datagram number (failed): 6 (6)
Table 1-2 display ipv6 netstream export command output description
|
Field |
Description |
|
IPv6 export information |
Statistics about IPv6 NetStream version 9 data export |
|
Stream source interface |
Source interface from which the IPv6 NetStream data are exported |
|
Stream destination vpn-instance |
VPN to which the destination address of the IPv6 NetStream data export belongs |
|
Stream destination IP(UDP) |
Destination address and port number of IPv6 NetStream data export (UDP) |
|
Version 9 exported stream number |
Number of flows that have been sent |
|
Version 9 exported UDP datagram number (failed) |
Number of UDP packets that failed to be sent |
Syntax
display ipv6 netstream template [ slot slot-number ]
View
Any view
Default Level
1: Monitor level
Parameters
slot slot-number: Displays NetStream template information of the specified device. If the device is in an IRF, the slot-number argument represents the member ID of the device; if the device is not in any IRF, the slot-number argument represents the device ID.
Description
Use the display ipv6 netstream template command to view configuration and status information about the NetStream version 9 template.
Examples
# Display information about the NetStream template on a distributed router.
<Sysname> display ipv6 netstream template slot 2
Stream template refresh-rate packet : 20
Stream template refresh-rate time(in minute) : 30
Active stream templates : 6
Added stream templates : 8
destination-prefix outbound template:
Template ID : 295
Packets : 0
Last template export time : Never
Field count : 13
Field type Field length (byte)
---------------------------------------------------------------------------
Flows 4
Out packets 8
Out bytes 8
First switched 4
Last switched 4
IPv6 destination address 16
IPv6 destination mask 1
IP protocol version 1
Destination AS 2
Output SNMP 2
Direction 1
Sampling algorithm 1
Sampling interval 4
destination-prefix inbound template:
Template ID : 294
Packets : 0
Last template export time : Never
Field count : 13
Field type Field length (byte)
---------------------------------------------------------------------------
Flows 4
In packets 8
In bytes 8
First switched 4
Last switched 4
IPv6 destination address 16
IPv6 destination mask 1
IP protocol version 1
Destination AS 2
Output SNMP 2
Direction 1
Sampling algorithm 1
Sampling interval 4
Table 1-3 display ipv6 netstream template command output description
|
Field |
Description |
|
Stream template refresh-rate packet |
Template refresh rate |
|
Stream template refresh-rate time(in minute) |
Refresh rate of the time of the template |
|
Active stream templates |
Number of active stream templates at present |
|
Added stream templates |
Number of templates created since the system starts |
|
destination-prefix outbound template |
Information of the destination-prefix template in the outbound direction |
|
destination-prefix inbound template |
Information of the destination-prefix template in the inbound direction |
|
Packets |
Number of packets sent using the template. A packet may contain multiple flows and different flows may use different templates; therefore, the number of packets is in fact the number of flows. |
|
Last template export time |
Last time when the template was exported |
|
Field count |
Total number of fields in a template |
Syntax
enable
undo enable
View
NetStream aggregation view
Default Level
3: Manage level
Parameters
None
Description
Use the enable command to enable current IPv6 aggregation.
Use the undo enable command to disable current IPv6 aggregation.
By default, no IPv6 aggregation is enabled.
Related commands: ipv6 netstream aggregation.
Examples
# Enable IPv6 NetStream prefix aggregation.
<Sysname> system-view
[Sysname] ipv6 netstream aggregation prefix
[Sysname-ns6-aggregation-prefix] enable
Syntax
ipv6 netstream aggregation { destination-prefix | prefix | protocol-port | source-prefix }
View
System view
Default Level
3: Manage level
Parameters
destination-prefix: Destination-prefix aggregation by destination AS number, destination address mask length, destination prefix, and outbound interface index.
prefix: Source and destination prefix aggregation by combination of source AS number, destination AS number, source address mask length, destination address mask length, source prefix, destination prefix, inbound interface index, and outbound interface index.
protocol-port: Protocol-port aggregation by combination of protocol number, source port, and destination port.
source-prefix: Source-prefix aggregation by combination of source AS number, source address mask length, source prefix, and inbound interface index.
Description
Use the ipv6 netstream aggregation command to set an IPv6 NetStream aggregation mode and enter the IPv6 aggregation view.
In an IPv6 NetStream aggregation view, you can enable or disable the specific aggregation, and configure the source interface and destination address for IPv6 NetStream data export.
Related commands: enable, ipv6 netstream export host, ipv6 netstream export source.
Examples
# Set the IPv6 NetStream aggregation mode as prefix and enter the NetStream prefix aggregation view.
<Sysname> system-view
[Sysname] ipv6 netstream aggregation prefix
[Sysname-ns6-aggregation-prefix]
Syntax
ipv6 netstream aggregation advanced
undo ipv6 netstream aggregation advanced
View
System view
Default Level
3: Manage level
Parameters
None
Description
Use the ipv6 netstream aggregation advanced command to enable IPv6 NetStream hardware aggregation.
Use the undo ipv6 netstream aggregation advanced command to disable IPv6 NetStream hardware aggregation.
By default, IPv6 NetStream hardware aggregation is disabled.
Note that:
l The configuration in NetStream aggregation view applies to IPv6 NetStream hardware aggregation, if enabled.
l The IPv6 NetStream hardware aggregation data export and NetStream common data export are mutually exclusive. The hardware aggregation will not take effect if the destination address for IPv6 NetStream common data export (ipv6 netstream export host in system view) is configured.
l The IPv6 NetStream hardware aggregation entries are stored in the cache where IPv6 NetStream common data entries are recorded, and then exported.
Related commands: ipv6 netstream export host, ipv6 netstream aggregation
Examples
# Enable IPv6 NetStream hardware aggregation.
<Sysname> system-view
[Sysname] ipv6 netstream aggregation advanced
Syntax
ipv6 netstream export host ip-address udp-port [ vpn-instance vpn-instance-name ]
undo ipv6 netstream export host [ ip-address [ vpn-instance vpn-instance-name ] ]
View
System view, NetStream aggregation view
Default Level
3: Manage level
Parameters
ip-address: Destination IP address for IPv6 NetStream data export. At present, only IPv4 addresses are supported.
udp-port: Destination UDP port number for NetStream data export, in the range 0 to 65535.
vpn-instance vpn-instance-name: Name of the VPN in which routes are to be queried for IPv6 NetStream data export.
Description
Use the ipv6 netstream export host command to set the destination address for IPv6 NetStream data export, and specify the VPN in which routes are to be queried.
Use the undo ipv6 netstream export host command to delete a specified export address or all exports addresses that are specified in this view.
By default, no destination address is configured in system view or in IPv6 NetStream aggregation view.
Note that:
l If IPv6 NetStream aggregation is not enabled, the destination IP address and UDP port number for its data export cannot be displayed.
l Different destination addresses can be configured in different aggregation views.
l If the ip-address argument is not specified in the undo ipv6 netstream export host command, all the IP addresses configured in the current view are removed.
l If no destination address is configured in aggregation view, the configuration in system view, if any, applies.
l Up to four different destination addresses, including addresses in different VPNs can be configured in one aggregation view. If you have configured the destination addresses with the same IP addresses but different UDP port numbers, the latest configuration takes effect. If you configure different VPN names, you can configure destination addresses with the same IP address and UDP port number.
l IPv6 NetStream common data export are exported to all destination addresses configured in system view while IPv6 NetStream aggregation data are exported to all destination addresses configured in the related aggregation view. If you expect IPv6 NetStream aggregation data only, configure the destination address in the aggregation view and do not configure the destination address in system view; otherwise, the IPv6 NetStream common data are also be exported, which will increase the bandwidth occupation.
Related commands: ipv6 netstream aggregation, ipv6 netstream export source.
Examples
# Configure the destination address for NetStream data export as 1.1.1.1, port 5000, and vpn1.
<Sysname> system-view
[Sysname] ipv6 netstream export host 1.1.1.1 5000 vpn-instance vpn1
Syntax
ipv6 netstream export rate rate
undo ipv6 netstream export rate
View
System view
Default Level
3: Manage level
Parameters
rate: Maximum rate for exporting IPv6 NetStream data, in the unit of the maximum number of packets per second, in the range 1 to 1000.
Description
Use the ipv6 netstream export rate command to configure the limit on the IPv6 NetStream data export.
Use the undo ipv6 netstream export rate command to remove the IPv6 NetStream data export limit.
By default, the export rate of IPv6 NetStream data is not limited.
Examples
# Allow 10 packets at most to be exported per second.
<Sysname> system-view
[Sysname] ipv6 netstream export rate 10
Syntax
ipv6 netstream export source interface interface-type interface-number
undo ipv6 netstream export source
View
System view, NetStream aggregation view
Default Level
3: Manage level
Parameters
interface-type interface-number: Specifies a source interface for NetStream data export by its type and number.
Description
Use the ipv6 netstream export source command to configure the source interface for IPv6 NetStream data export.
Use the undo ipv6 netstream export source command to remove the configuration.
By default, the interface connecting to the NetStream server is used as the source interface.
l Different source interfaces can be configured in different aggregation views.
l If no source interface is configured in aggregation view, the source interface configured in system view, if any, is used.
l It is recommended to connect the network management interface to the NetStream server and configure it as the source interface.
Related commands: ipv6 netstream aggregation.
Examples
# Configure the source interface for IPv6 NetStream data export as Vlan-interface1.
<Sysname> system-view
[Sysname] ipv6 netstream export source interface Vlan-interface 1
Syntax
ipv6 netstream export v9-template refresh-rate packet packets
undo ipv6 netstream export v9-template refresh-rate packet
View
System view
Default Level
3: Manage level
Parameters
packets: Specifies the refresh frequency with which version 9 templates are resent to the NetStream server for an update, that is, the template is resent every packets packets. It is in the range 1 to 600 and defaults to 20.
Description
Use the ipv6 netstream export v9-template refresh-rate packet command to configure the refresh rate frequency with which an IPv6 NetStream version 9 template is resent.
Use the undo ipv6 netstream export v9-template refresh-rate packet command to restore the default.
By default, a version 9 template is resent every 20 packets.
Note that:
l Because version 9 is template-based and supports user-defined formats, the NetStream device needs to resend a new template to the NetStream server for an update. If the version 9 format is changed on the NetStream device and not updated on the NetStream server, the server is unable to associate the received statistics with its proper fields. To avoid such situation, you can configure the refresh frequency and rate for version 9 templates so that the NetStream server can refresh the templates on time
l The refresh frequency and interval can be both configured, and the template is resent when either of the condition is reached.
Related commands: ipv6 netstream export v9-template refresh-rate time.
Examples
# Set the packet refresh frequency to 100 so that a NetStream version 9 template is resent every 100 packets.
<Sysname> system-view
[Sysname] ipv6 netstream export v9-template refresh-rate packet 100
Syntax
ipv6 netstream export v9-template refresh-rate time minutes
undo ipv6 netstream export v9-template refresh-rate time
View
System view
Default Level
3: Manage level
Parameters
minutes: Specifies the refresh interval at which the IPv6 NetStream version 9 template is resent. That is, the template is resent every minutes minutes. It is in the range 1 to 3600, and defaults to 30.
Description
Use the ipv6 netstream export v9-template refresh-rate time command to configure the refresh interval at which an IPv6 NetStream version 9 template is resent.
Use the undo ipv6 netstream export version command to restore the default.
By default, a version 9 template is resent every 30 minutes.
Note that:
l Because version 9 is template-based and supports user-defined formats, the NetStream device needs to resend a new template to the NetStream server for an update. If the version 9 format is changed on the NetStream device and not updated on the NetStream server, the server is unable to associate the received statistics with its proper fields. To avoid such situation, you can configure the refresh frequency and rate for version 9 templates so that the NetStream server can refresh the templates on time.
l The refresh frequency and interval can be both configured, and the template is resent when either of the condition is reached.
Related commands: ipv6 netstream export v9-template refresh-rate packet.
Examples
# Set the refresh interval to 60 so that a NetStream version 9 template is resent every 60 minutes.
<Sysname> system-view
[Sysname] ipv6 netstream export v9-template refresh-rate time 60
Syntax
ipv6 netstream export version 9 [ origin-as | peer-as ] [ bgp-nexthop ]
undo ipv6 netstream export version
View
System view
Default Level
3: Manage level
Parameters
origin-as: Specifies to record the number of AS originating the BGP route.
peer-as: Specifies to record the AS number of the BGP peers.
bgp-nexthop: Specifies to record the BGP next hops.
Description
Use the ipv6 netstream export version 9 command to configure to record which AS numbers and/or the BGP next hops for IPv6 NetStream version 9 export format.
Use the undo ipv6 netstream export version command to restore the default.
By default, version 9 format is used to export IPv6 NetStream common data, IPv6 NetStream aggregation data, and MPLS flow data with IPv6 fields; the AS number of the BGP peers is recorded, if any; the BGP next hop is not recorded.
The AS numbers for the source and destination IP addresses of a NetStream flow are recorded. Each IP address corresponds with two AS numbers (origin and peer), and the system records the AS numbers according to the configured AS option..
Examples
# Configure to export NetStream data in version 9 format and record the number of AS that originates the BGP route.
<Sysname> system-view
[Sysname] ipv6 netstream export version 9 origin-as
Syntax
reset ipv6 netstream statistics
View
User view
Default Level
2: System level
Parameters
None
Description
Use the reset ipv6 netstream statistics command to age out and export all IPv6 NetStream data and clear the cache.
After you execute the command, messages appear, telling you that the process of clearing the cache will take several minutes and the system does not perform NetStream during this process.
Examples
# Age out and export all IPv6 NetStream data and clear the cache.
<Sysname> reset ipv6 netstream statistics
This process may take a few minutes.
Netstream statistic function is disabled during this process.
