11-Network Management and Monitoring Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C S6520X-EI[HI][SI] & S6520-SI & S5560X-HI Switch Series Command References-R65xx-6W10311-Network Management and Monitoring Command Reference
03-iNQA commands
Title Size Download
03-iNQA commands 162.51 KB

iNQA commands

iNQA collector commands

 

analyzer

Use analyzer to bind an analyzer to a collector instance.

Use undo analyzer to restore the default.

Syntax

analyzer analyzer-id [ udp-port port-number ] [ vpn-instance vpn-instance-name ]

undo analyzer

Default

No analyzer is bound to a collector instance.

Views

Collector view

Collector instance view

Predefined user roles

network-admin

Parameters

analyzer-id: Specifies an analyzer ID in dotted decimal format. It must be the same as the analyzer ID configured on the analyzer.

udp-port port-number: Specifies a UDP port on the analyzer for the collector to communicate with the analyzer. The value range is 1024 to 65535, and the default is 53312. As a best practice, use the default value. If you use other values, make sure the specified value is the same as that configured on the analyzer by using the protocol udp-port command.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. To specify an analyzer on the public network, do not specify this option.

Usage guidelines

A collector instance must be bound to an analyzer so that the collector can send instance-specific data to the analyzer.

The binding between the analyzer and the collector is used as follows:

1.     The collector encapsulates the data collected from MPs into packets, uses the analyzer ID bound to a collector instance as the destination IPv4 address, and sends the packets to the analyzer.

2.     The analyzer compares the analyzer ID in the packets with its own ID.

¡     If a match is found, the analyzer accepts the packets and summarizes the data in the packets.

¡     If no match is found, the analyzer identifies the packets illegal and discards them.

For the successful communication, make sure the specified analyzer ID meets the following requirements:

·     The analyzer ID and a collector can reach each other.

·     The analyzer ID bound to a collector instance must be the same as the analyzer ID configured on an analyzer by using the analyzer id command.

You can bind an analyzer to a collector instance or a specific collector.

·     An analyzer specified in collector view is bound to all collector instances.

·     An analyzer specified in collector instance view is bound to the specific collector instance.

The analyzer ID in collector instance view takes precedence over that in collector view. If no analyzer ID is specified in collector instance view, the analyzer ID in collector view applies.

A collector and a collector instance can be bound to only one analyzer. If you execute this command multiple times in the same view, the most recent configuration takes effect.

Examples

# Bind all collector instances to the analyzer with ID 10.1.1.1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] analyzer 10.1.1.1

# Bind collector instance 1 to the analyzer with ID 11.1.1.1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] analyzer 11.1.1.1

collector id

Use collector id to specify a collector ID.

Use undo collector id to restore the default.

Syntax

collector id collector-id

undo collector id

Default

No collector ID is specified.

Views

Collector view

Predefined user roles

network-admin

Parameters

collector-id: Specifies a collector ID in dotted decimal format, for example, 10.1.1.1. The collector ID must be an IPv4 address that already exists on the collector.

Usage guidelines

The collector ID is used for communication between the analyzer and collector as follows:

1.     The collector encapsulates the data collected from MPs into packets, uses its ID as the source IPv4 address, and sends the packets to the analyzer.

2.     The analyzer compares the collector ID in the packets with collector IDs bound to analyzer instances.

¡     If a match is found, the analyzer accepts the packets and summarizes the data in the packets.

¡     If no match is found, the analyzer identifies the packet illegal and discards them.

For the successful communication, make sure the specified collector ID meets the following requirements:

·     The ID must be globally unique. As a best practice, configure the Router ID of the device as the collector ID.

·     The specified collector ID must be the same as the collector ID bound to an analyzer instance on the analyzer.

You can execute the collector command on the analyzer to bind the specified collector ID to an analyzer instance.

·     The collector ID and the analyzer can reach each other.

Examples

# Specify 10.1.1.1 as the collector ID.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] collector id 10.1.1.1

description

Use description to configure a description for a collector instance.

Use undo description to restore the default.

Syntax

description text

undo description

Default

A collector instance does not have a description.

Views

Collector instance view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 64 characters.

Usage guidelines

A description allows easy identification of a collector instance.

Examples

# Set the description to AtoB for collector instance 1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] description AtoB

display inqa collector

Use display inqa collector to display the collector configuration.

Syntax

display inqa collector

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the collector configuration.

<Sysname> display inqa collector

Collector ID             : 10.1.1.1

Loss-measure flag        : 5

Analyzer ID              : 10.2.2.2

Analyzer UDP-port        : 53312

VPN-instance-name        : --

Current instance count   : 2

Table 1 Command output

Field

Description

Collector ID

Collector ID.

Loss-measure flag

ToS field bit to flag packet loss measurement. The value is 5.

Analyzer ID

ID of the analyzer bound to the collector.

Analyzer UDP-port

UDP port number for the communication between the analyzer and collector.

VPN-instance-name

Name of the VPN instance to which the analyzer belongs.

Current instance count

Total number of collector instances.

display inqa collector instance

Use display inqa collector instance to display the collector instance configuration.

Syntax

display inqa collector instance { instance-id | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance-id: Specifies a collector instance ID in the range of 1 to 8355838.

all: Displays the configuration of all collector instances.

Examples

# Display the configuration of collector instance 1.

<Sysname> display inqa collector instance 1

Instance ID              : 1

Status                   : Enabled

Duration                 : --

Description              : AtoB

Analyzer ID              : 10.2.2.2

Analyzer UDP-port        : 53312

VPN-instance-name        : --

Interval                 : 10 sec

Flow configuration:

  flow bidirection source-ip 10.1.1.1 destination-ip 10.2.2.2 protocol udp source-port 1025

MP configuration:

  mp 100 in-point inbound, GE1/0/1

  mp 200 in-point inbound, GE1/0/2

# Display the configuration of all collector instances.

<Sysname> display inqa collector instance all

Instance ID             : 1

Status                  : Enabled

Duration                : --

Description             : AtoB

Analyzer ID             : 10.2.2.2

Analyzer UDP-port       : 53312

VPN-instance-name       : --

Interval                : 10 sec

Flow configuration:

  flow bidirection source-ip 10.1.1.1 destination-ip 10.2.2.2 protocol udp source-port 1025

MP configuration:

  mp 100 in-point inbound, GE1/0/1

  mp 200 in-point inbound, GE1/0/2

 

Instance ID             : 2

Status                  : Disable

Duration                : --

Description             : BtoA

Analyzer ID             : 10.2.2.3

Analyzer UDP-port       : 53312

VPN-instance-name       : --

Interval                : 10 sec

Flow configuration:

  flow forward source-ip 10.1.1.2 destination-ip 10.2.2.3 protocol udp source-port 1025

MP configuration:

  mp 300 in-point inbound, GE1/0/3

  mp 400 mid-point outbound, GE1/0/4

Table 2 Command output

Field

Description

Instance ID

Collector instance ID.

Status

Collector instance status:

·     Enabled.

·     Disabled.

Duration

Period of the fixed duration packet loss measurement.

Description

Description for the collector instance.

Analyzer ID

ID of the analyzer bound to the collector instance.

Analyzer UDP-port

UDP port number for the communication between the analyzer and collector

VPN-instance-name

Name of the VPN instance to which the analyzer belongs.

Interval

Measurement interval for the collector instance.

Flow configuration

Configuration of the flow monitored by the collector instance.

MP configuration

MP configuration.

flag

Use flag to specify a ToS field bit to flag packet loss measurement.

Use undo flag to restore the default.

Syntax

flag loss-measure tos-bit tos-bit

undo flag loss-measure

Default

No ToS field bit is specified to flag packet loss measurement.

Views

Collector view

Predefined user roles

network-admin

Parameters

tos-bit tos-bit: Specifies a ToS field bit. The device supports only value 5.

Usage guidelines

iNQA uses ToS field bit 5 in the IPv4 packet header as the flag bit. By setting the flag bit value to 1 or 0 alternately at intervals to distinguish a target flow from unintended traffic flows.

The ToS field consist of a 6-bit (bits 0 to 5) DSCP filed and a 2-bit (bits 6 and 7) ECN field. If bit 5 is used as the flag bit, to avoid inaccurate packet loss statistics, do not use it for DSCP purposes.

To modify the flag bit for a collector instance that is already enabled, you must disable the collector instance first.

Examples

# Specify ToS field bit 5 as the flag bit.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] flag loss-measure tos-bit 5

flow (collector instance view)

Use flow to specify a flow to be monitored by a collector instance.

Use undo flow to remove the flow settings.

Syntax

flow { backward | bidirection | forward } { destination-ip dest-ip-address [ dest-mask-length ] | dscp dscp-value | protocol { { tcp | udp } { destination-port dest-port-number1 [ to dest-port-number2 ] | source-port src-port-number1 [ to src-port-number2 ] } * | protocol-number } | source-ip src-ip-address [ src-mask-length ] } *

undo flow { backward | bidirection | forward }

Default

No flow is specified for a collector instance.

Views

Collector instance view

Predefined user roles

network-admin

Parameters

backward: Specifies a backward flow.

bidirection: Specifies the symmetric bidirectional flows. If you specify this keyword, both the src-ip-address and dest-ip-address arguments are required.

forward: Specifies a forward flow.

destination-ip dest-ip-address: Specifies a destination IPv4 address of the flow, in dotted decimal format. Only the unicast IPv4 addresses are supported.

dest-mask-length: Specifies a mask length for the destination IPv4 address. The value range is 1 to 32, and the default is 32.

dscp dscp-value: Specifies a DSCP value of the flow, in the range of 0 to 63. If bit 5 is used as the flag bit, do not specify this option to avoid inaccurate packet loss statistics.

protocol: Specifies a protocol type of the flow.

·     { tcp | udp }: Specifies the TCP or UDP protocol.

¡     destination-port dest-port-number1 [ to dest-port-number2 ]: Specifies a single destination port or a range of destination ports. The value range is 0 to 65535. For a port range, the dest-port-number2 argument must be higher than the dest-port-number1 argument.

¡     source-port src-port-number1 [ to src-port-number2 ]: Specifies a single source port or a range of source ports. The value range is 0 to 65535. For a port range, the src-port-number2 argument must be higher than the src-port-number1 argument.

·     protocol-number: Specifies the number of the protocol type. The value range is 0 to 255, excluding 6 (TCP protocol number) and 17 (UDP protocol number).

source-ip src-ip-address: Specifies a source IPv4 address of the flow, in dotted decimal format. Only the unicast IPv4 addresses are supported.

src-mask-length: Specifies a mask length for the source IPv4 address. The value range is 1 to 32, and the default is 32.

Usage guidelines

The target flows are key elements for iNQA operations. You can specify a flow by using any combination of the following items: protocol type, source IPv4 address, destination IPv4 address, source port number, destination port number, and DSCP value. Using more items defines a more explicit flow and generates more accurate analysis data.

A collector instance can monitor a maximum of two flows. Follow these guidelines when you specify the target flows:

·     To monitor only one flow, specify the forward keyword. The collector instance does not support monitoring only a backward flow.

·     To monitor two flows:

¡     If the endpoint devices of the two flows are the same, use the bidirection keyword, and specify both the destination IPv4 address and source IPv4 address..

¡     If the endpoint devices of the two flows are not identical, specify a forward flow and then a backward flow. Alternatively, you can create two collector instances, and specify a forward flow in each collector instance.

For the flows to be monitored by different collector instances, the flow attributes must not be identical.

For a forward flow and backward flow monitored by a collector instance, the flow attributes cannot be all identical. If they have the same attributes except the direction, define them as bidirectional flows.

Examples

# Configure collector instance 1 to monitor the forward UDP flow from 10.1.1.1 to 20.1.1.1 with the source port number 1025.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] flow forward source-ip 10.1.1.1 destination-ip 20.1.1.1 protocol udp source-port 1025

# Configure collector instance 2 to monitor the forward flow from 1.1.1.1 to 2.2.2.2 and to monitor the backward TCP flow from 3.3.3.3 to 1.2.3.4 with the destination port number 1024.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 2

[Sysname-inqa-collector-instance-1] flow forward source-ip 1.1.1.1 destination-ip 2.2.2.2

[Sysname-inqa-collector-instance-1] flow backward source-ip 3.3.3.3 destination-ip 1.2.3.4 protocol tcp destination-port 1024

# Configure collector instance 3 to monitor the bidirectional UDP flows between 10.1.1.1 and 20.1.1.1 with the source port number 1025.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 3

[Sysname-inqa-collector-instance-3] flow bidirection source-ip 10.1.1.1 destination-ip 20.1.1.1 protocol udp source-port 1025

inqa collector

Use inqa collector to enable the collector functionality and enter its view, or enter the view of an enabled collector.

Use undo inqa collector to disable the collector functionality.

Syntax

inqa collector

undo inqa collector

Default

The collector functionality is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The intelligent network quality analyzer (iNQA) operations include the following device roles:

·     Collector—Manages measurement points (MPs), collects data from MPs, and reports the data to the analyzer.

·     Analyzer—Collects the data from collectors and summarizes the data.

After you configure this command on a device, the device functions as a collector.

You can enable the collector and analyzer functionalities on different devices or the same device.

Examples

# Enable the collector functionality and enter its view.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector]

Related commands

collector id

inqa mp

Use inqa mp to bind an MP to an interface.

Use undo inqa mp to unbind an MP from an interface.

Syntax

inqa mp mp-id

undo inqa mp

Default

No interface is bound to an MP.

Views

Ethernet interface view

Aggregate interface view

Predefined user roles

network-admin

Parameters

mp-id: Specifies an MP ID in the range of 1 to 16777215.

Usage guidelines

An MP can be bound to only one interface, and one interface can be bound to only one MP.

After an interface is bound to an MP, iNQA can count the number of packets passing through the interface.

Examples

# Bind GigabitEthernet 1/0/1 to MP 100.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] inqa mp 100

Related commands

mp

instance (collector view)

Use instance to create a collector instance and enter its view, or enter the view of an existing collector instance.

Use undo instance to delete a collector instance.

Syntax

instance instance-id

undo instance instance-id

Default

No collector instance exists on a collector.

Views

Collector view

Predefined user roles

network-admin

Parameters

instance-id: Specifies a collector instance ID in the range of 1 to 8355838.

Usage guidelines

A collector collects data based on the collector instance. You can configure the target flows, MPs, measurement interval, and bound analyzer ID for a collector instance.

To collect packet loss statistics on the same target flow passing through multiple collectors, create an instance on the analyzer and each collector, and make sure the instance IDs are the same.

Examples

# Create instance 1 on the collector.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

Related commands

Description (collector instance view)

flow (collector instance view)

mp

interval (collector instance view)

interval

Use interval to specify the measurement interval for a collector instance.

Use undo interval to restore the default.

Syntax

interval interval

undo interval

Default

The measurement interval for a collector instance is 10 seconds.

Views

Collector instance view

Predefined user roles

network-admin

Parameters

interval: Specifies a measurement interval in seconds. The available values are 10, 60, and 600.

Usage guidelines

During a measurement interval, a collector instance counts the packets reported form MPs and reports the data results to the analyzer. Set a proper interval according to your measurement requirements and the actual network conditions.

The shorter the interval, the more frequently the data is reported to the analyzer, which might affect the processing performance of collector and the analyzer. Make sure the same collector instance on all collectors uses the same measurement interval.

Examples

# Set the measurement interval to 60 seconds for collector instance 1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] interval 60

Related commands

flow (collector instance view)

instance (collector view)

loss-measure enable continual

Use loss-measure enable continual to enable continual packet loss measurement for a collector instance.

Use undo loss-measure enable continual to disable continual packet loss measurement for a collector instance.

Syntax

loss-measure enable continual

undo loss-measure enable continual

Default

The continual packet loss measurement is disabled.

Views

Collector instance view

Predefined user roles

network-admin

Usage guidelines

To avoid unperceived packet loss, enable continual packet loss measurement. Once starting, it does not stop unless you execute the undo loss-measure enable continual command to disable it manually.

For a collector instance, the fixed duration and continual packet loss measurements cannot be both enabled.

Examples

# Enable continual packet loss measurement for collector instance 1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] loss-measure enable continual

Related commands

loss-measure enable duration

loss-measure enable duration

Use loss-measure enable duration to enable the fixed duration packet loss measurement for a collector instance.

Use undo loss-measure enable duration to disable the fixed duration packet loss measurement for a collector instance.

Syntax

On non-middle points:

loss-measure enable duration [ duration ]

undo loss-measure enable duration

On middle points:

loss-measure enable mid-point duration [ duration ]

undo loss-measure enable mid-point duration

Default

The fixed duration packet loss measurement is disabled.

Views

Collector instance view

Predefined user roles

network-admin

Parameters

mid-point: Enable this feature on middle points. The middle points apply to point-to-point performance measurements.

duration: Specifies the number of minutes for which the measurement lasts. The values can be 5, 10, 15, and 30, and the default is 10.

Usage guidelines

iNQA counts the packet loss information in the specified time period. It is helpful when you want to measure the network performance in a time period or to accurately locate the fault points for packet loss.

This command will not be saved to the configuration file. The packet loss measurement cannot survive the master/subordinate, active/standby switchover, or device reboot.

For a collector instance, the fixed duration and continual packet loss measurements cannot be both enabled.

Examples

# Run the packet loss measurement for 30 minutes for collector instance 1.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] loss-measure enable duration 30

Related commands

loss-measure enable continual

mp

Use mp to configure an MP.

Use undo mp to delete an MP.

Syntax

mp mp-id { in-point | mid-point | out-point } port-direction { inbound | outbound }

undo mp mp-id

Default

No MP is configured.

Views

Collector instance view

Predefined user roles

network-admin

Parameters

mp-id: Specifies an MP ID in the range of 1 to 16777215.

in-point: Specifies the MP as an ingress point. An ingress point colors the forward flow, and decolors the backward flow, and collects packet statistics for the forward flow.

mid-point: Specifies the MP as a middle point. A middle point only collects packet statistics for the target flow.

out-point: Specifies the MP as an egress point. An egress point decolors the forward flow, colors the backward flow, and collects packet statistics for the backward flow.

inbound: Specifies the flows entering the MP.

outbound: Specifies the flow leaving MP.

Usage guidelines

A collector instance measures the data passing through MPs. After specifying a collector instance, configure an MP.

Specify the in-point, mid-point, or out-point keyword as follows:

·     If the MP is the first point that the target flow passes through, specify the in-point keyword for the MP.

·     If the MP is the final point that the target flow passes through, specify the out-point keyword for the MP.

·     If you define an MP between an ingress point and egress point, specify the mid-point keyword for the MP. When packet loss occurs between an ingress point and egress point, you can specify middle points to locate the problem.

Specify the port direction as follows:

·     To collect the statistics on the flows entering the MP, specify the inbound keyword.

·     To collect the statistics on the flows leaving the MP, specify the outbound keyword.

One MP cannot be both an ingress point and an egress point of a measured flow.

Examples

# Configure ingress MP 100 for collector instance 1 to collect traffic data for the flows entering the MP.

<Sysname> system-view

[Sysname] inqa collector

[Sysname-inqa-collector] instance 1

[Sysname-inqa-collector-instance-1] mp 100 in-point port-direction inbound

Related commands

inqa mp

iNQA analyzer commands

ams

Use ams to create an atomic measurement span (AMS) and enter its view, or enter the view of an existing AMS.

Use undo ams to delete an AMS. After an AMS is deleted, all settings in AMS view are deleted.

Syntax

ams ams-id

undo ams ams-id

Default

No AMS exists.

Views

Analyzer instance view

Predefined user roles

network-admin

Parameters

ams-id: Specifies an AMS ID in the range of 1 to 2147483647.

Usage guidelines

To measure point-to-point packet loss, configure AMSs in an analyzer instance.

For an AMS to measure the packet loss rate of a target flow, the following tasks are required in the AMS view:

·     Configure the direction of the target flow.

·     Configure the ingress MP group and egress MP group.

Examples

# Create an AMS and enter its view.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] ams 1

Related commands

flow (analyzer AMS view)

in-group

out-group

analyzer id

Use analyzer id to specify an analyzer ID.

Use undo analyzer id to restore the default.

Syntax

analyzer id analyzer-id

undo analyzer id

Default

No analyzer ID is specified.

Views

Analyzer view

Predefined user roles

network-admin

Parameters

analyzer-id: Specifies an analyzer ID in dotted decimal format, for example, 10.1.1.1. The analyzer ID must be an IPv4 address that already exists on the analyzer.

Usage guidelines

The analyzer ID is used for communication between the analyzer and collector as follows:

1.     The collector encapsulates the data collected from MPs into packets, uses the analyzer ID as the destination IPv4 address, and sends the packets to the analyzer.

2.     The analyzer compares the analyzer ID in the packets with its own ID.

¡     If a match is found, the analyzer accepts the packets and summarizes the data in the packets.

¡     If no match is found, the analyzer identifies the packets illegal and discards them.

For the successful iNQA communication, make sure the specified analyzer ID meets the following requirements:

·     The analyzer ID must be an IPv4 address that can be routable from the collector.

·     The specified analyzer ID must be the same as the analyzer ID bound to a collector instance on the collector.

·     As a best practice, configure the Router ID of the device as the analyzer ID.

With this command configured, iNQA uses the configured analyzer ID and the port number configured by the protocol udp-port command to start the UDP server. If the configured UDP port number is used by other services, the UDP server cannot be started, causing the configuration failure of this command.

Examples

# Specify 10.1.1.1 as the analyzer ID.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] analyzer id 10.1.1.1

Related commands

protocol udp-port

collector

Use collector to bind a collector to an analyzer instance.

Use undo collector to unbind a collector from an analyzer instance.

Syntax

collector collector-id

undo collector [ collector-id ]

Default

No collector is bound to an analyzer instance.

Views

Analyzer instance view

Predefined user roles

network-admin

Parameters

collector-id: Specifies a collector ID in dotted decimal format, for example, 10.1.1.1. The collector ID must be the same as that configured on the collector. If you do not specify this argument in the undo collector command, you unbind all collectors from the analyzer instance.

Usage guidelines

To bind multiple collectors to an analyzer instance, repeat this command. The analyzer instance collects and analyzes the reported data of all bound collectors.

Specify the collector ID the same as that specified on the collector in the collector id command.

After you enable the measurement functionality for an analyzer instance, you cannot modify the bound collectors. To modify the collectors bound to an analyzer instance, first disable the measurement functionality for the analyzer instance.

Examples

# Bind analyzer instance 1 to the collector whose ID is 10.1.1.1.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] collector 10.1.1.1

Related commands

collector id

description

Use description to configure a description for an analyzer instance.

Use undo description to restore the default.

Syntax

description text

undo description

Default

An analyzer instance does not have a description.

Views

Analyzer instance view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 64 characters.

Usage guidelines

A description allows easy identification of an analyzer instance.

Examples

# Set the description to AtoB for analyzer instance 1.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] description AtoB

display inqa analyzer

Use display inqa analyzer to display the analyzer configuration.

Syntax

display inqa analyzer

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the analyzer configuration.

<Sysname> display inqa analyzer

Analyzer ID              : 10.1.1.1

Protocol UDP-port        : 53312

Current instance count   : 1

Table 3 Command output

Field

Description

Analyzer ID

Analyzer ID.

Protocol UDP-port

UDP port number for the communication between the analyzer and collector.

Current instance count

Total number of analyzer instances.

display inqa analyzer instance

Use display inqa analyzer instance to display the analyzer instance configuration.

Syntax

display inqa analyzer instance { instance-id | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance-id: Specifies an analyzer instance ID in the range of 1 to 8355838.

all: Displays the configuration of all analyzer instances.

Examples

# Display the configuration of analyzer instance 1.

<Sysname> display inqa analyzer instance 1

Instance ID              : 1

Status                   : Enabled

Description              : AtoB

Alarm upper-limit        : 8.000000%

Alarm lower-limit        : 4.500000%

Current AMS count        : 2

Collectors               : 10.1.1.1

                           12.56.66.21

                           21.23.13.14

# Display the configuration of all analyzer instances.

<Sysname> display inqa analyzer instance all

Instance ID              : 1

Status                   : Enabled

Description              : AtoB

Alarm upper-limit        : 8.000000%

Alarm lower-limit        : 4.500000%

Current AMS count        : 2

Collectors               : 10.1.1.1

                           12.56.66.21

                           21.23.13.14

 

Instance ID              : 2

Status                   : Enabled

Description              : BtoA

Alarm upper-limit        : 8.000000%

Alarm lower-limit        : 4.500000%

Current AMS count        : 2

Collectors               : 10.1.1.2

                           12.56.66.22

                           21.23.13.15

Table 4 Command output

Field

Description

Instance ID

Analyzer instance ID.

Status

Analyzer instance status:

·     Enabled.

·     Disabled.

Description

Description of the analyzer instance.

Alarm upper-limit

Packet loss upper limit.

Alarm lower-limit

Packet loss lower limit.

Collectors

IDs of the collector bound to the analyzer instance.

Current AMS count

Total number of AMSs in the analyzer instance.

display inqa analyzer instance ams

Use display inqa analyzer instance ams to display the AMS configuration in an analyzer instance.

Syntax

display inqa analyzer instance instance-id ams { ams-id | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance-id: Specifies an analyzer instance ID in the range of 1 to 8355838.

ams-id: Specifies an AMS ID in the range of 1 to 2147483647.

all: Displays the configuration of all AMSs in an analyzer instance.

Examples

# Display the configuration of AMS 1 in analyzer instance 1.

<Sysname> display inqa analyzer instance 1 ams 1

AMS ID                   : 1

Flow direction           : forward

In-group                 : collector 10.1.1.1 mp 20

                           collector 12.56.66.21 mp 100

Out-group                : collector 21.23.13.14 mp 110

# Display the configuration of all AMSs in analyzer instance 1.

<Sysname> display inqa analyzer instance 1 ams all

AMS ID                   : 1

Flow direction           : forward

In-group                 : collector 10.1.1.1 mp 20

                           collector 12.56.66.21 mp 100

Out-group                : collector 21.23.13.14 mp 110

 

AMS ID                   : 2

Flow direction           : forward

In-group                 : collector 21.23.13.14 mp 110

Out-group                : collector 21.23.13.15 mp 120

Table 5 Command output

Field

Description

AMS ID

AMS ID.

Flow direction

Direction of the flow to be measured by the analyzer.

In-group

Ingress MP group for the AMS.

Out-group

Egress MP group for the AMS.

display inqa statistics loss

Use display inqa statistics loss to display iNQA packet loss statistics.

Syntax

display inqa statistics loss instance instance-id [ ams ams-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance-id: Specifies an analyzer instance ID in the range of 1 to 8355838.

ams ams-id: Specifies an AMS ID in the range of 1 to 2147483647. If you do not specify this option, the system displays the end-to-end packet loss statistics of an analyzer instance.

Usage guidelines

With the ams keyword specified, the system displays the point-to-point packet loss statistics and then you can locate the fault point based on the statistics.

The iNQA data in the first measurement interval might be incorrect. As a best practice, do not use it to judge the network performance.

Examples

# Display iNQA packet loss statistics of analyzer instance 1.

<Sysname> display inqa statistics loss instance 1

Latest packet loss statistics for forward flow:

 Period     LostPkts             PktLoss%     LostBytes            ByteLoss%

 19122483   15                   15.000000%   1500                 15.000000%

 19122482   15                   15.000000%   1500                 15.000000%

 19122481   15                   15.000000%   1500                 15.000000%

 19122480   15                   15.000000%   1500                 15.000000%

 19122479   15                   15.000000%   1500                 15.000000%

 19122478   15                   15.000000%   1500                 15.000000%

Latest packet loss statistics for backward flow:

Period     LostPkts             PktLoss%     LostBytes            ByteLoss%

 19122483   15                   15.000000%   1500                 15.000000%

 19122482   15                   15.000000%   1500                 15.000000%

 19122481   15                   15.000000%   1500                 15.000000%

 19122480   15                   15.000000%   1500                 15.000000%

 19122479   15                   15.000000%   1500                 15.000000%

 19122478   15                   15.000000%   1500                 15.000000%

Table 6 Command output

Field

Description

Latest packet loss statistics for forward flow

Most recent statistics about target forward flow

Latest packet loss statistics for backward flow

Most recent statistics about target backward flow.

Period

Index of the measurement interval.

LostPkts

Number of lost packets.

PktLoss%

Packet loss rate.

Packet loss rate = (Total number of packets at the ingress MP – Total number of packets at the egress MP)/Total number of packets at the ingress MP.

If the clock of the collectors are not synchronized, or the ingress MP do not report any data, the packet loss rate might be negative. The minimum packet loss rate is –100%.

LostBytes

Number of lost bytes.

ByteLoss%

Byte loss rate.

Byte loss rate = (Total number of bytes at the ingress MP – Total number of bytes at the egress MP)/Total number of bytes at the ingress MP.

If the clock of the collectors are not synchronized, or the ingress MP do not report any data, the byte loss rate might be negative. The minimum packet loss rate is –100%.

flow (analyzer AMS view)

Use flow to specify the flow direction to be measured in an analyzer AMS.

Use undo flow to restore the default.

Syntax

flow { backward | bidirection | forward }

undo flow

Default

No flow direction is specified to be measured in the analyzer AMS.

Views

Analyzer AMS view

Predefined user roles

network-admin

Parameters

backward: Specifies a backward flow.

bidirection: Specifies the symmetric bidirectional flows.

forward: Specifies a forward flow.

Usage guidelines

The command is a must if you configure an AMS for point-to-point packet loss measurements.

The collector and analyzer each provide a flow command, and the direction keywords (forward, backward, and bidirection) in these commands function differently.

·     In collector instance view, the collector instance collects the statistics about the flows of the specified direction and reports the statistics to the analyzer.

·     In analyzer AMS view, the analyzer calculates the statistics about the flows of the specified direction.

The following matrix shows how the direction setting in the flow command results in different data calculation on the analyzer:

 

In collector instance view

In analyzer AMS view

Analyzer calculates data for

bidirection

forward

Only the forward flow.

The analysis data does not contains statistics for the backward flow.

forward

backward

Only for the backward flow.

Because the collectors does not report any backward flow data, the backward flow statistics in the AMS is 0.

 

Examples

# Specify forward flow to be measured in analyzer AMS 1 on analyzer 1.

<Sysname> system-view

[Sysname] inqa  analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] ams 1

[Sysname-inqa-analyzer-instance-1-ams-1] flow forward

Related commands

flow (analyzer AMS view)

in-group

Use in-group to add an MP to the ingress MP group for an AMS.

Use undo in-group to remove an MP from the ingress MP group for an AMS.

Syntax

in-group collector collector-id mp mp-id

undo in-group [ collector collector-id mp mp-id ]

Default

The ingress MP group does not have any MP.

Views

Analyzer AMS view

Predefined user roles

network-admin

Parameters

collector collector-id: Specifies the ID of the collector where the MP resides, in dotted decimal format.

mp mp-id: Specifies an MP ID in the range of 1 to 16777215.

Usage guidelines

If packet loss occurs in a specific segment of the network, divide the network segment into multiple AMSs to locate the AMS where packet loss occurs.

The ingress MP group is required for an AMS. You can repeat this command to add multiple MPs to the ingress MP group.

Examples

# Add MP 100 of the collector with ID 10.1.1.1 to the ingress MP group for AMS 1 in analyzer instance 1.

<Sysname> system-view

[Sysname] inqa  analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] ams 1

[Sysname-inqa-analyzer-instance-1-ams-1] in-group collector 10.1.1.1 mp 100

Related commands

out-group

inqa analyzer

Use inqa analyzer to enable the analyzer functionality and enter its view, or enter the view of an enabled analyzer.

Use undo inqa analyzer to disable the analyzer functionality.

Syntax

inqa analyzer

undo inqa analyzer

Default

The analyzer functionality is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The intelligent network quality analyzer (iNQA) operations include the following device roles:

·     Collector—Manages measurement points (MPs), collects data from MPs, and reports the data to the analyzer.

·     Analyzer—Collects the data from collectors and summarizes the data.

After you configure this command on a device, the device functions as an analyzer.

You can enable the collector and analyzer functionalities on different devices or the same device.

Examples

# Enable the analyzer functionality and enter its view.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer]

instance (analyzer view)

Use instance to create an analyzer instance and enter its view, or enter the view of an existing analyzer instance.

Use undo instance to delete an analyzer instance.

Syntax

instance instance-id

undo instance instance-id

Default

No analyzer instance exists on an analyzer.

Views

Analyzer view

Predefined user roles

network-admin

Parameters

instance-id: Specifies an analyzer instance ID in the range of 1 to 8355838.

Usage guidelines

An analyzer instance collects and counts the measurement results for the same target flow passing through all collectors in the instance.

For an analyzer instance, you must bind it to a collector and choose to configure the description, packet loss upper limit, and packet loss lower limit. If you want to perform point-to-point performance measurements for an analyzer instance, configure AMSs.

To collect packet loss statistics on the same target flow passing through multiple collectors, create an instance on the analyzer and each collector, and make sure the instance IDs are the same.

Examples

# Create instance 1 on the analyzer.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

loss-measure alarm

Use loss-measure alarm to configure packet loss logging for an analyzer instance.

Use undo loss-measure alarm to restore the default.

Syntax

loss-measure alarm upper-limit upper-limit lower-limit lower-limit

undo loss-measure alarm

Default

The packet loss logging is not configured for an analyzer instance. The analyzer will not generate logs for threshold crossing events.

Views

Analyzer instance view

Predefined user roles

network-admin

Parameters

upper-limit upper-limit: Specifies the packet loss upper limit, a string of 1 to 10 characters. The value range is 0.000001% to 100%, correct to six decimal places. The threshold is crossed if the packet loss rate exceeds it.

lower-limit lower-limit: Specifies the packet loss lower limit, a string of 1 to 10 characters. The value range is 0.000001% to 100%, correct to six decimal places. It must not be greater than the upper limit. The threshold is crossed if the packet loss rate drops below it.

Usage guidelines

iNQA calculates the packet loss rate periodically, and the analyzer generates a log on five consecutive crossings of a threshold.

·     If the packet loss rate exceeds the upper limit for consecutive five measurement intervals, the analyzer sends a log to the information center.

·     If the packet loss rate is less than the lower limit for consecutive five measurement intervals, the analyzer sends an event clearing log to the information center.

You can configure the information center to determine whether to output logs and the output destination. For more information about the information center, see "Configuring information center."

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper limit to 8% and the lower limit to 4.5% for analyzer instance 1.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] loss-measure alarm upper-limit 8 lower-limit 4.5

measure enable (analyzer instance view)

Use measure enable to enable the measurement functionality of an analyzer instance.

Use undo measure enable to disable the measurement functionality of an analyzer instance.

Syntax

measure enable

undo measure enable

Default

The measurement functionality of an analyzer instance is disabled.

Views

Analyzer instance view

Predefined user roles

network-admin

Usage guidelines

To avoid incorrect statistics on the analyzer, do not modify the iNQA settings on the collector when the measurement functionality of an analyzer instance is enabled. To modify the iNQA settings on a collector, perform the following steps:

1.     On the analyzer, execute the undo measure enable command to disable the measurement functionality of the analyzer instance bound to a collector.

2.     Log in to the collector and modify the collector settings.

3.     On the analyzer, execute the measure enable command to enable the measurement functionality of the analyzer instance.

Examples

# Enable the measurement functionality of analyzer instance 1.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] measure enable

out-group

Use out-group to add an MP to the egress MP group for an AMS.

Use undo out-group to remove an MP from the egress MP group for an AMS.

Syntax

out-group collector collector-id mp mp-id

undo out-group [ collector collector-id mp mp-id ]

Default

The egress MP group does not have any MP.

Views

Analyzer AMS view

Predefined user roles

network-admin

Parameters

collector collector-id: Specifies the ID of the collector where the MP resides, in dotted decimal format.

mp mp-id: Specifies an MP ID in the range of 1 to 16777215.

Usage guidelines

If packet loss occurs in a specific segment of the network, divide the network segment into multiple AMSs to locate the AMS where packet loss occurs.

The egress MP group is required for an AMS. You can repeat this command to add multiple MPs to an egress MP group.

Examples

# Add MP 200 of the collector with ID 2.1.1.1 to the egress MP group for AMS 1 in analyzer instance 1.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] instance 1

[Sysname-inqa-analyzer-instance-1] ams 1

[Sysname-inqa-analyzer-instance-1-ams-1] out-group collector 20.1.1.1 mp 200

Related commands

in-group

protocol udp-port

Use protocol udp-port to specify a UDP port for communication between the analyzer and collectors.

Use undo protocol udp-port to restore the default.

Syntax

protocol udp-port port-number

undo protocol udp-port

Default

The UDP port number used for communication between the analyzer and collectors is 53312.

Views

Analyzer view

Predefined user roles

network-admin

Parameters

port-number: Specifies a UDP port number in the range of 1024 to 65535.

Usage guidelines

With the analyzer id command configured, iNQA uses the configured analyzer ID and the port number configured by this command to start the UDP server. If the configured UDP port number is used by other services, the UDP server cannot be started, causing the failure of the analyzer. To resolve this issue, modify the UDP port number and then configure the analyzer id command again.

Specify a UDP port number the same as that in the analyzer command in collector instance view. Otherwise, the communication between the collectors and the analyzer fails.

Examples

# Specify UDP port 1024 for communication between the analyzer and collectors.

<Sysname> system-view

[Sysname] inqa analyzer

[Sysname-inqa-analyzer] analyzer id 10.1.1.1

Related commands

analyzer (collector instance view)

analyzer id