- Table of Contents
-
- 13-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-iNQA commands
- 04-NTP commands
- 05-PTP commands
- 06-Network synchronization commands
- 07-SNMP commands
- 08-RMON commands
- 09-NETCONF commands
- 10-EAA commands
- 11-Process monitoring and maintenance commands
- 12-Sampler commands
- 13-Mirroring commands
- 14-NetStream commands
- 15-IPv6 NetStream commands
- 16-sFlow commands
- 17-Information center commands
- 18-GOLD commands
- 19-Packet capture commands
- 20-VCF fabric commands
- 21-CWMP commands
- 22-SmartMC commands
- 23-SQA commands
- 24-eMDI commands
- 25-Performance management commands
- 26-Event MIB commands
- 27-EPS agent commands
- 28-Cloud connection commands
- 29-EPA commands
- 30-Packet trace commands
- Related Documents
-
Title | Size | Download |
---|---|---|
25-Performance management commands | 82.12 KB |
Contents
Performance management commands
display performance-management statistics
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
mdc-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 Ten-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 ten-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
mdc-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.
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 : ten-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
mdc-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
mdc-admin
Usage guidelines
To configure performance statistics tasks, you must enter 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
mdc-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
mdc-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
mdc-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
mdc-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: 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