17-Network Management and Monitoring Command Reference

HomeSupportResource CenterTechnical DocumentsReference GuidesCommand ReferencesH3C MSR810[830][2600][3600] Routers Command Reference(V7)-R0821-6W50017-Network Management and Monitoring Command Reference
18-Performance management commands
Title Size Download
18-Performance management commands 82.02 KB

Performance management commands

binding

Use binding to bind performance management instances to a performance statistics task.

Use undo binding to remove a performance management instance binding.

Syntax

binding instance-type instance-type { all { physical | tunnel } | instance instance-name&<1-8> }

undo binding instance-type instance-type { all { physical | tunnel } | instance instance-name&<1-8> }

Default

No performance management instances are bound to a performance statistics task.

Views

Statistics task view

Predefined user roles

network-admin

Parameters

instance-type instance-type: Specifies the instance type, a case-insensitive string of 1 to 63 characters. The instance types are predefined by features. The current software version supports only the interface type.

all physical: Specifies all physical interfaces.

all tunnel: Specifies all tunnel interfaces.

instance instance-name&<1-8>: Specifies a space-separated list of up to eight instance names. The list is a case-insensitive string of 1 to 255 characters. The instance names are predefined by features. The specified instances must exist and belong to the specified instance type.

Examples

# Bind instance GigabitEthernet 1/0/1 to performance statistics task task1.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm] statistics task task1

[Sysname-pm-task-task1] binding instance-type interface instance gigabitethernet 1/0/1

Related commands

statistics task

display performance-management statistics

Use display performance-management statistics to display the performance statistics for a performance statistics task.

Syntax

display performance-management statistics task-name data index [ instance-type instance-type [ measure measure-name | instance instance-name &<1-8> ] * ]

Views

Any view

Predefined user roles

network-admin

Parameters

task-name: Specifies a performance statistics task by its name, a case-insensitive string of 1 to 31 characters. The name must start with a letter or digit and can contain only letters, digits, and underscores (_).

data index: Specifies a statistics interval by its index, an integer in the range of 0 to 16. Index 0 refers to the most recent interval. An interval with a smaller index is closer to the index with index 0.

instance-type instance-type: Specifies the instance type, a case-insensitive string of 1 to 63 characters. The instance types are predefined by features. Each feature has an instance type. If you do not specify an instance type, this command displays the statistics for all types of instances.

measure measure-name: Specifies a statistics item by its name, a case-insensitive string of 1 to 63 characters. Supported statistics item vary by instance. Table 1 lists all statistics items.

instance instance-name&<1-8>: Specifies a space-separated list of up to eight instance names. The list is a case-insensitive string of 1 to 255 characters. The instance names are predefined by features.

Table 1 Statistics items

Statistics item

Description

in-errors

Number of received erroneous packets.

out-errors

Number of sent erroneous packets.

in-discards

Number of received packets that were discarded.

out-discards

Number of sent packets that were discarded.

in-octets

Number of received bytes.

out-octets

Number of sent bytes.

in-ucast-pkts

Number of received unicast packets.

out-ucast-pkts

Number of sent unicast packets.

in-multicast-pkts

Number of received multicast packets.

out-multicast-pkts

Number of sent multicast packets.

in-broadcast-pkts

Number of received broadcast packets.

out-broadcast-pkts

Number of sent broadcast packets.

in-bandwidth-rate

Input bandwidth usage.

out-bandwidth-rate

Output bandwidth usage

in-all-pkts

Total number of received packets.

out-all-pkts

Total number of sent packets.

in-pkts-rate

Packet input rate.

out-pkts-rate

Packet output rate.

in-bits-rate

Inbound bit rate.

out-bits-rate

Outbound bit rate.

 

Usage guidelines

If performance statistics is not enabled or the specified task does not exist, the command does not display any statistics.

Examples

# Display the performance statistics for performance statistics task task1 in the most recent statistics interval.

<Sysname> display performance-management statistics task1 data 1

Total measures: 20

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

Instance type              : interface

Instance name              : gigabitethernet 1/0/1

Measure name               : in-all-pkts

Validity flag              : Valid

Statistical timestamp      : 2018-04-23 18:30:00 UTC-08:00

Latest performance value   : 800

Latest value timestamp     : 2018-04-23 18:18:30 UTC-08:00

Peak performance value     : 1000

Peak value timestamp       : 2018-04-23 18:17:30 UTC-08:00

Valley performance value   : 100

Valley value timestamp     : 2018-04-23 18:16:30 UTC-08:00

Average performance value  : 500

...

Table 2 Command output

Field

Description

Total measures

Number of statistics items.

Measure name

Statistics item name.

Validity flag

Validity flag for the statistics item:

·     No statistics—No statistics have been collected for the item.

·     Valid—Collected statistics are valid.

Statistical timestamp

End time of the statistics interval in one of the following formats:

·     YYYY-MM-DD hh:mm:ss

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm DST

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm

·     YYYY-MM-DD hh:mm:ss DST

If you specify index 0 for the command, this field displays the end time of the most recent statistics interval.

If the clock timezone command has been executed to specify a time zone, this field contains the UTC±hh:mm part. If the clock summer-time has been executed to specify a time zone, this field contains DST.

Latest performance value

Final sample value of the most recent statistics interval.

If the instance does not support the statistics item, this field displays a hyphen (-).

If you specify index 0 for the command, this field displays the final sample value.

Latest value timestamp

End time of the most recent sampling interval during the statistics interval, in one of the following formats:

·     YYYY-MM-DD hh:mm:ss

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm DST

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm

·     YYYY-MM-DD hh:mm:ss DST

If the clock timezone command has been executed to specify a time zone, this field contains the UTC±hh:mm part. If the clock summer-time has been executed to specify a time zone, this field contains DST.

If you specify index 0 for the command, this field displays the end time of the most recent sampling interval.

Peak performance value

Biggest sample value during the statistics interval.

Peak value timestamp

Time when the biggest sample value was sampled, in one of the following formats:

·     YYYY-MM-DD hh:mm:ss

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm DST

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm

·     YYYY-MM-DD hh:mm:ss DST

If the clock timezone command has been executed to specify a time zone, this field contains the UTC±hh:mm part. If the clock summer-time has been executed to specify a time zone, this field contains DST.

Valley performance value

Smallest sample value during the statistics interval.

Valley value timestamp

Time when the smallest sample value was sampled, in one of the following formats:

·     YYYY-MM-DD hh:mm:ss

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm DST

·     YYYY-MM-DD hh:mm:ss UTC±hh:mm

·     YYYY-MM-DD hh:mm:ss DST

If the clock timezone command has been executed to specify a time zone, this field contains the UTC±hh:mm part. If the clock summer-time has been executed to specify a time zone, this field contains DST.

Average performance value

Average sample value during the statistics interval.

 

display performance-management task

Use display performance-management task to display performance statistics task information.

Syntax

display performance-management task [ task-name ]

Views

Any view

Predefined user roles

network-admin

Parameters

task-name: Specifies a performance statistics task by its name, a case-insensitive string of 1 to 31 characters. The name must start with a letter or digit and can contain only letters, digits, and underscores (_). If you do not specify this argument, the command displays information about all performance statistics tasks.

Usage guidelines

If performance statistics is not enabled or the specified task does not exist, the command does not display any information.

Examples

# Display information about performance statistics task task1.

<Sysname> display performance-management task task1

Task Name                : task1

Task State               : running

Statistics Interval      : 15

Sample Interval          : 5

Instance Type            : interface

Table 3 Command output

Field

Description

Task Name

Name of the performance statistics task.

Task State

Running status of the task:

·     running—The task is in progress.

·     ready—The task is not in progress.

Statistics Interval

Performance statistics interval in minutes.

Sample Interval

Performance sampling interval in seconds.

Instance Type

Type of the instances.

If no instances are bound to the task, this field displays a hyphen (-).

 

performance-management

Use performance-management to enter performance management view.

Syntax

performance-management

Views

System view

Predefined user roles

network-admin

Usage guidelines

To configure performance statistics tasks, you must enter performance management view.

The performance-management command is displayed in the output of the display current-configuration command even if performance management is not enabled and no configuration exits in performance management view.

Examples

# Enter performance management view.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm]

sample interval

Use sample interval to set the performance sampling interval.

Use undo sample interval to restore the default.

Syntax

sample interval interval

undo sample interval

Default

The default sampling interval varies by the statistics interval, as shown in Table 4.

Views

Statistics task view

Predefined user roles

network-admin

Parameters

interval: Specifies the performance sampling interval in seconds. The available sampling interval values vary by statistics interval, as shown in Table 4.

Usage guidelines

A shorter sampling interval produces more precise statistics but consumes more resources.

When you change the statistics interval, the system automatically changes the sampling interval to the corresponding default.

The default sampling interval and the possible sampling interval values vary by statistics interval, as shown in Table 4.

Table 4 Sampling interval defaults and available sampling interval values

Statistics interval (minutes)

Default sampling interval (seconds)

Available sampling interval values (seconds)

5

5

5, 10, 15, and 30

10

5

5, 10, 15, 30, and 60

15

5

5, 10, 15, 30, and 60

30

60

5, 10, 15, 30, and 60

60

300

5, 10, 15, 30, 60, and 300

1440

900

300, 600, 900, 1800, and 3600

 

When the sampling interval changes for a performance statistics task, the system automatically deletes all performance statistics for the task and recollects the performance statistics.

Examples

# Set the sampling interval to 300 seconds for performance statistics task task1.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm] statistics task task1

[Sysname-pm-task-task1] statistics interval 60

[Sysname-pm-task-task1] sample interval 300

statistics interval

Use statistics interval to set the performance statistics interval.

Use undo statistics interval to restore the default.

Syntax

statistics interval interval

undo statistics interval

Default

The performance statistics interval is 15 minutes.

Views

Statistics task view

Predefined user roles

network-admin

Parameters

interval: Specifies the performance statistics interval in minutes. Values include 5, 10, 15, 30, 60, or 1440.

Usage guidelines

A performance statistics task can have only one statistics interval. A statistics interval change takes effect immediately on all instances in the performance statistics task.

A shorter statistics interval produces more precise statistics but consumes more resources.

After you set the statistics interval for a performance statistics task and enable performance statistics, the device uses the following rules to determine the start time for the task:

·     If the interval is less than or equal to 60 minutes, the start time is the beginning of the next complete period. For example, if you set the performance statistics interval to 15 minutes and enable performance statistics at 8:40, the start time is 8:45.

·     If the interval is greater than 60 minutes, the start time is 00:00 in the morning on the next day.

When you change the statistics interval for a performance statistics task, the system automatically performs the following operations:

·     Changes the sampling interval to the corresponding default shown in Table 4.

·     Deletes all performance statistics for the task and recollects the performance statistics.

Examples

# Set the performance statistics interval to 5 minutes for performance statistics task task1.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm] statistics task task1

[Sysname-pm-task-task1] statistics interval 5

statistics enable

Use statistics enable to enable performance statistics.

Use undo statistics enable to disable performance statistics.

Syntax

statistics enable

undo statistics enable

Default

Performance statistics is disabled.

Views

Performance management view

Predefined user roles

network-admin

Usage guidelines

Execute the undo statistics enable command with caution. The command terminates all performance statistics tasks in the system.

Examples

# Enable performance statistics.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm] statistics enable

statistics task

Use statistics task to create a performance statistics task and enter its view.

Use undo statistics task to delete a performance statistics task.

Syntax

statistics task task-name

undo statistics task task-name

Default

No performance statistics tasks exist in the system.

Views

Performance management view

Predefined user roles

network-admin

Parameters

task-name: Specifies a performance statistics task name, a case-insensitive string of 1 to 31 characters. The name must start with a letter or digit and can contain only letters, digits, and underscores (_).

Usage guidelines

IMPORTANT

IMPORTANT:

Deleting a performance statistics task terminates the task and deletes all performance statistics for the task.

 

Performance sampling and statistics collection are performed on a statistics task basis.

The device supports a maximum of 16 statistics tasks.

Execute the undo statistics task command with caution. The command terminates the specified performance statistics task and deletes all performance statistics for the task.

Examples

# Create a performance statistics task named task1.

<Sysname> system-view

[Sysname] performance-management

[Sysname-pm] statistics task task1

[Sysname-pm-task-task1]

Related commands

performance-management