No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Performance Management Commands

Performance Management Commands

binding

Function

The binding command binds an instance to a performance statistics collection task.

The undo binding command unbinds an instance from a performance statistics collection task.

By default, no instance is bound to a performance statistics collection task.

Format

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

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

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

all Binds all instances.

When all is specified, instance-type can only be ipfpm.

-

instance instance-name

Specifies the name of an instance of a specific type.

The value is a string of 1 to 255 case-insensitive characters.
  • If instance-type is set to card, the value of instance-name is master, slave, or slot slot-id, for example, slot1.

  • If instance-type is set to interface, the value of instance-name is interface type interface number, for example, 10ge1/0/1 and eth-trunk2

  • If instance-type is set to nqa, the value of instance-name is admin-name-test-name, for example, admin-nqatest. The admin-name and test-name are configured using the nqa test-instance admin-name test-name command.

  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) instance-id command.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After you bind an instance to a performance statistics collection task, the system collects performance data of the instance. Multiple instances can be bound to a performance statistics collection task.

Precautions

If the bound instance is an Ethernet interface or Eth-Trunk interface, pay attention to the following points:

Traffic statistics on the interface are collected at the default interval (300s). This means that the forwarding rate and bandwidth usage of the interface will not change within 300s. If the value of cycle specified in the statistics-cycle cycle command is smaller than 300s (5 minutes), the performance statistics (the forwarding rate and bandwidth usage) about the interface remain unchanged, which cannot reflect the actual traffic on the interface.

To resolve this issue, use either of the following methods:
  • Run the set flow-stat interval interval-time command to set the traffic statistics collection interval on the interface to a smaller value, ranging from 10 seconds to 600 seconds.
  • Run the statistics-cycle cycle command to increase the performance statistics collection cycle.

Example

# Bind an interface instance 10GE1/0/1 to the performance statistics collection task task1.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] binding instance-type interface instance 10ge1/0/1
Related Topics

display pm

Function

The display pm command displays brief PM information.

Format

display pm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After PM is configured, you can run the display pm command to view brief PM information, such as the PM status, number of performance statistics tasks, number of performance statistics files.

Example

# Display brief PM information.

<HUAWEI> display pm
Statistics Status                   : enable                                                                                        
Statistics Start Time               : 2017-10-31 10:38:17                                                                           
Current Statistics Cycles           : 5 minutes                                                                                     
Number of Statistics Tasks          : 1                                                                                             
Number of Statistics Objects        : 1                                                                                             
Number of Configured Pm Servers     : 0                                                                                             
Number of Statistics Files          : 4                                                                                             
Statistics Files Saved Directory    : /pmdata/ 
Table 5-86  Description of the display pm command output

Item

Description

Statistics Status Whether PM is enabled. The value can be:
  • enable
  • disable
Statistics Start Time Time when the performance statistics function starts.
Current Statistics Cycles Interval at which performance statistics are collected.
Number of Statistics Tasks Number of performance statistics tasks.

Number of Statistics Objects

Number of performance statistics objects.
Number of Configured Pm Servers Number of configured PM servers.
Number of Statistics Files Number of performance statistics files.
Statistics Files Saved Directory Path where performance statistics files are saved.

display pm measure-info

Function

The display pm measure-info command displays information about performance statistics counters.

Format

display pm measure-info [ instance-type instance-type ]

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics task.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Before running the measure disable command to configure performance statistics counters for instances of a specific type, run the display pm measure-info command to view information about available performance statistics counters, including the name, type, maximum value, and minimum value of each counter.

Example

# Display information about performance statistics counters of the instance of the interface type.

<HUAWEI> display pm measure-info instance-type interface
Total instance types: 1, total measures: 35
--------------------------------------------------------------------------------
Instance Type: interface, Measures Count: 35
  Measure Name                : in-discards
  Measure Type                : Increase
  Measure Counter Size(bits)  : 32
  Measure MaxValue            : 4294967295
  Measure MinValue            : 0

  Measure Name                : in-errors
  Measure Type                : Increase
  Measure Counter Size(bits)  : 32
  Measure MaxValue            : 4294967295
  Measure MinValue            : 0

  Measure Name                : out-discards
  Measure Type                : Increase
  Measure Counter Size(bits)  : 32
  Measure MaxValue            : 4294967295
  Measure MinValue            : 0
......
Table 5-87  Description of the display pm measure-info command output

Item

Description

Instance Type

Type of an instance.

Measures Count

Number of a performance statistics counter.

Measure Name

Name of a performance statistics counter.

Measure Type

Type of a performance statistics counter. The value can be:

  • Increase: Accumulated performance statistics are compared with the counter.
  • Actual: The currently collected performance statistics are compared with the counter.
  • Maximum: The maximum performance statistics are compared with the counter.
  • Minimum: The minimum performance statistics are compared with the counter.
  • Average: The average performance statistics are compared with the counter.

Measure Counter Size(bits)

Size of a performance statistics counter, 32 bits or 64 bits.

Measure MaxValue

Maximum value of a performance statistics counter.

Measure MinValue

Minimum value of a performance statistics counter.

display pm statistics

Function

The display pm statistics command displays the collected performance statistics.

Format

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

Parameters

Parameter Description Value
task-name Displays the performance statistics of a specified performance statistics collection task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

data-index index Displays the performance statistics collected at a specified interval.

The value is an integer that ranges from 0 to 16.

  • If the value is 0, the current performance statistics are displayed.

  • If the value is larger than 0, the performance statistics collected in one or more cycles are displayed. The smaller the value, the latest the statistics.

    • If a short performance statistics collection cycle (5, 10, 15, 30, or 60 minutes) is set, the value of index ranges from 1 to 16.

    • If a long performance statistics collection cycle (1440 minutes) is set, the value of index ranges from 1 to 3.

instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

measure measure-name Specifies the name of a statistics counter.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

instance instance-name Specifies the name of an instance.
The value is a string of 1 to 255 case-insensitive characters.
  • If instance-type is set to card, the value of instance-name is master, slave, or slot slot-id, for example, slot1.

  • If instance-type is set to interface, the value of instance-name is interface type interface number, for example, 10ge1/0/1 and eth-trunk2

  • If instance-type is set to nqa, the value of instance-name is admin-name-test-name, for example, admin-nqatest. The admin-name and test-name are configured using the nqa test-instance admin-name test-name command.

  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) instance-id command.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view the current or historical performance statistics, run the display pm statistics command. The system can display the current performance statistics and historical performance statistics collected in a maximum of 16 cycles.

Example

# Display the current performance statistics of the performance statistics collection task task1.

<HUAWEI> display pm statistics task1 data-index 0
Total measures count: 29
--------------------------------------------------------------------------------
Instance Type        : interface
Instance Name        : 10GE1/0/1
Measure Name         : in-discards
Measure Data         : 0
Valid Flag           : valid
Timestamp            : 2013-07-03 16:47:41

Instance Type        : interface
Instance Name        : 10GE1/0/1
Measure Name         : in-errors
Measure Data         : 0
Valid Flag           : valid
Timestamp            : 2013-07-03 16:47:41

Instance Type        : interface
Instance Name        : 10GE1/0/1
Measure Name         : out-discards
Measure Data         : 0
Valid Flag           : valid
Timestamp            : 2013-07-03 16:47:41

......
Table 5-88  Description of the display pm statistics command output

Item

Description

Total measures count

Number of a performance statistics counter.

Instance Type

Type of an instance bound to a performance statistics collection task.

Instance Name

Name of an instance bound to a performance statistics collection task.

Measure Name

Name of a performance statistics counter.

Measure Data

Statistics counter.

0: The statistics counter is not supported.

Valid Flag

Valid flag of the performance statistics. The value can be:

  • no statistics: The performance statistics are not collected.
  • valid: The performance statistics are valid.
  • incredible value: The performance statistics are not reliable.
  • measure not configured: The statistics counter is disabled.

Timestamp

Time when the performance statistics are collected.

display pm statistics-file

Function

The display pm statistics-file command displays performance statistics files.

Format

display pm statistics-file [ task-name ]

Parameters

Parameter Description Value
task-name Displays the performance statistics files generated for a performance statistics task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After a performance statistics task starts, the system automatically generates performance statistics files for the task. To view the performance statistics files generated for the performance statistics task, run the display pm statistics-file command.

Example

# Display performance statistics files for all performance statistics tasks.

<HUAWEI> display pm statistics-file
Total files count: 1                                                            
--------------------------------------------------------------------------------
Task Name: test                                                                 
  test20130701150001.txt                                                        
                                                                                
Table 5-89  Description of the display pm statistics-file command output

Item

Description

Total files count

Number of performance statistics files.

Task Name

Name of a performance statistics task.

display pm statistics-task

Function

The display pm statistics-task command displays information about a performance statistics collection task.

Format

display pm statistics-task [ task-name ]

Parameters

Parameter Description Value
task-name Displays the information about a specified performance statistics collection task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check information about a performance statistics collection task, including the running status of the task, statistics collection cycle, and type of the instance bound to the task.

Example

# Display information about performance statistics collection tasks.

<HUAWEI> display pm statistics-task
Total task count: 1
--------------------------------------------------------------------------------
Task Name                : test
Task State               : running
Record-file Status       : enable
Task Cycle               : 15 minutes
Sample Interval          : 3 minutes
Instance Type            : interface
Record Interval(cycle)   : 4
File Format              : text
File Name Prefix         : test
File Transfer Mode       : passive
Current File Name        : test20130701150001.txt
                                                 
Table 5-90  Description of the display pm statistics-task command output

Item

Description

Total task count

Number of performance statistics collection tasks.

Task Name

Name of a performance statistics collection task.

The task name is specified in the statistics-task task-name command.

Task State

Running status of a performance statistics collection task.

Record-file Status

Whether performance statistics file generation is enabled. The value can be:
  • enable: This function is enabled.

  • disable: This function is not enabled.

This function is configured using the record-file disable command.

Task Cycle

Performance statistics collection cycle configured in a performance statistics collection task.

This parameter is configured using the statistics-cycle cycle command.

Sample Interval

Sampling interval configured in a performance statistics collection task.

This parameter is configured using the sample-interval interval command.

Instance Type

Type of an instance bound to a performance statistics collection task.

This parameter is configured using the binding instance-type instance-type instance instance-name & <1-8> command.

Record Interval(cycle)

Interval at which the system generates performance statistics files.

This parameter is configured using the record-interval interval command.

File Format

Format of performance statistics files. The value can be:
  • text: text file

  • xml: XML file

This parameter is configured using the file-format { text | xml } command.

File Name Prefix

Name prefix of a performance statistics file.

File Transfer Mode

Mode in which statistics files are uploaded to the performance management server. The value can be:
  • active: The device automatically uploads statistics files to the performance management server.

  • passive: The device uploads statistics files to the performance management server following the instructions from the command line interface or network management system.

Current File Name

Name of the current performance statistics file.

file-format

Function

The file-format command sets the format of performance statistics files.

The undo file-format command restores the default format of performance statistics files.

By default, a performance statistics file is generated in the text format.

Format

file-format { text | xml }

undo file-format

Parameters

Parameter Description Value
text

Sets the format of performance statistics files to text format.

-

xml

Sets the format of performance statistics files to XML format.

-

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An XML file occupies more storage space than a text file does. However, an XML file is more readable, expandable, and simpler for any application to read and write. To set the format of performance statistics files to text or XML, run the file-format command. A statistics file is named in either of the following formats:

  • Text format: performance statistics collection task name + YYMMDD + HHMM + file index.txt
  • XML format: performance statistics collection task name + YYMMDD + HHMM + file index.xml

A performance statistics file consists of a file header and a file body:

  • File header: includes the name of a device, software version running on the device, and performance statistics collection cycle.
  • File body: includes the time when performance statistics collection starts, type of performance statistics objects, performance statistics objects, counters of a performance statistics object, and counter values within a performance statistics collection cycle.

Prerequisites

  • An .xml file occupies more storage space than a .text file does. However, an .xml file is more readable and expandable.

  • If the format for the performance statistics files is .text, historical statistics collected within the number of intervals set using the record-interval command will be recorded. If the format for the performance statistics files is .xml, historical statistics collected within the latest one interval will be recorded.

Example

# Set the format of the performance statistics files to be generated for the performance statistics task task1 to .xml.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] file-format xml
Related Topics

measure disable

Function

The measure disable command disables measurement for statistics counters of an instance bound to a performance statistics collection task.

The undo measure disable command restores measurement for statistics counters of an instance bound to a performance statistics collection task to the default value.

By default, all statistics counters of the instance bound to the performance statistics collection task are measured.

Format

measure disable instance-type instance-type measure measure-name

measure disable instance-type instance-type all

undo measure disable instance-type instance-type measure measure-name

undo measure disable instance-type instance-type all

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

measure measure-name Specifies the name of a statistics counter in a performance statistics collection task.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

all Specifies statistics counters of statistics objects in all performance statistics tasks. -

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Each instance type supports multiple statistics counters. For example, an interface instance supports counters of interface speed, number of received error packets, and number of dropped packets. If you do not want to collect some counters, run this command to disable measurement of the statistics counters. Then the system does not measure these counters.

To check the statistics counters measured for an instance type, run the display pm measure-info [ instance-type instance-type ] command.

Prerequisites

An instance has been bound to a performance statistics collection task using the binding instance-type instance-type instance instance-name &<1-8> command.

Example

# Disable measurement of the in-errors counter for interface instances.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] binding instance-type interface instance 10ge1/0/1
[*HUAWEI-pm-statistics-task1] measure disable instance-type interface measure in-errors

measure enable

Function

The measure enable command enables measurement for statistics counters of an instance bound to a performance statistics collection task.

The undo measure enable command disables measurement for statistics counters of an instance bound to a performance statistics collection task.

By default, all statistics counters of the instance bound to the performance statistics collection task are measured.

Format

measure enable instance-type instance-type measure measure-name

undo measure enable instance-type instance-type measure measure-name

Parameters

Parameter Description Value
instance-type instance-type

Specifies the type of an instance bound to a performance statistics collection task.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

measure measure-name Specifies the name of a statistics counter in a performance statistics collection task.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Each instance type supports multiple statistics counters. For example, an interface instance supports counters of interface speed, number of received error packets, and number of dropped packets. You can run the measure enable or undo measure enable command to enable or disable measurement of some counters.

To check the statistics counters measured for an instance type, run the display pm measure-info [ instance-type instance-type ] command.

Prerequisites

An instance has been bound to a performance statistics collection task using the binding instance-type instance-type instance instance-name &<1-8> command.

Example

# Enable measurement of the in-errors counter for interface instances.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] binding instance-type interface instance 10ge1/0/1
[*HUAWEI-pm-statistics-task1] measure enable instance-type interface measure in-errors

path

Function

The path command configures the destination path to save performance statistics files on the PM server.

The undo path command deletes the configured destination path.

By default, performance statistics files are uploaded to the default path on a PM server.

Format

path destination-path

undo path

Parameters

Parameter Description Value
destination-path

Specifies the destination path to save performance statistics files on the PM server.

The value is a string of 1 to 63 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload performance statistics files to a specific path on the PM server, run the path command to specify the destination path.

Precautions

The specified destination path must exist in the performance management server. Otherwise, the statistics file cannot be uploaded to the server.

Example

# Specify the destination path to save performance statistics on the PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server server1
[~HUAWEI-pm-server-server1] path d:/pmdata
Related Topics

pm

Function

The pm command displays the PM view.

Format

pm

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the performance statistics function of PM, run the pm command to display the PM view.

Example

# Display the PM view.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm]

pm-server

Function

The pm-server command creates a process serving the PM server and displays the view of the PM server created in the process. If there is an existing PM server view, the pm-server command displays the PM server view without creating a process.

The undo pm-server command deletes the created process.

By default, no process serving the PM server is created.

Format

pm-server server-name

undo pm-server server-name

Parameters

Parameter Description Value
server-name Specifies the name of the process serving the PM server.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload generated performance statistics files to the PM server, run the pm-server command to create a process serving the PM server.

Follow-up Procedure

Configure the IP address and port number for the PM server, and user name and password for logging in to the PM server. Performance statistics files are uploaded to the PM server using FTP or SFTP.

Precautions

If a device is enabled to upload performance statistics files to a PM server, the process serving the PM server cannot be deleted.

Example

# Create a process named server1 to serve the PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server server1
[*HUAWEI-pm-server-server1]

protocol

Function

The protocol command configures the parameters for connecting to a PM server.

The undo protocol command deletes the parameters for connecting to a PM server.

By default, no PM server connection parameter is configured.

Format

protocol { ftp | sftp } ip-address ip-address [ port port-number | { net-manager-vpn | vpn-instance vpn-instance-name } ] *

undo protocol

Parameters

Parameter Description Value
ftp Uses the FTP protocol to upload performance statistics files. -
sftp Uses the SFTP protocol to upload performance statistics files. -
ip-address ip-address Specifies the IP address of the PM server. The value is in dotted decimal notation.
port port-number

Specifies the port number.

The value is an integer that ranges from 1 to 65535. The default port number is 21 (using FTP) or 22 (using SFTP).

net-manager-vpn

Indicates the network management VPN.

-
vpn-instance vpn-instance-name

Specifies a VPN instance name.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To upload statistics files to a PM server, use this command to configure connection parameters, including the transfer protocol, IP address, and port number of the PM server.

Precautions

Using FTP to upload performance statistics files is insecure. Therefore, using SFTP is recommended.

Example

# Configure the device to upload performance statistics files to the SFTP server with the IP address 10.1.1.1.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server server1
[~HUAWEI-pm-server-server1] protocol sftp ip-address 10.1.1.1
Related Topics

record-file disable

Function

The record-file disable command disables performance statistics file generation.

The undo record-file disable command restores performance statistics file generation.

By default, a performance statistics file is automatically generated and saved on the device. A maximum of four performance statistics files can be generated for each performance statistics collection task.

Format

record-file disable

undo record-file disable

Parameters

None

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

To save system resources, reduce system cost and operations on storage devices, and prolong the lifespan of storage devices during performance statistics collection, run the record-file disable command to prevent performance statistics files from being generated.

Each performance statistics collection task can generate a maximum of four statistics files. If more than four statistics files are generated, the new file replaces the earliest one.

Example

# Disable performance statistics file generation.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] record-file disable
Related Topics

record-interval

Function

The record-interval command sets the number of performance statistics collection cycles after which the system generates a statistics file.

The undo record-interval command restores the default number of performance statistics collection cycles.

By default:
  • If a short performance statistics collection cycle (5, 10, 15, 30, or 60 minutes) is set, the system generates a statistics file after four cycles.
  • If a long performance statistics collection cycle (1440 minutes) is set, the system generates a statistics file after one cycle.

Format

record-interval interval

undo record-interval

Parameters

Parameter Description Value
interval Specifies the number of performance statistics collection cycles. The value is an integer. The value range depends on the performance statistics collection cycle:
  • If a short performance statistics collection cycle is set, the value of interval ranges from 1 to 16, and the default value is 4.
  • If a long performance statistics collection cycle is set, the value of interval ranges from 1 to 3, and the default value is 1.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

After you configure a performance statistics collection task, the system periodically saves collected performance data to statistics files. To set the interval at which the system generates statistics files, run the record-interval command. Then the system generates performance statistics files every cycle x interval minutes, and automatically saves the performance data in the files. The system generates a maximum of four statistics files for each performance statistics collection task, and saves performance statistics files to the path flash: /pmdata by default.

Example

# Configure the system to save performance data to a statistics file every three performance statistics collection cycles. If the performance statistics collection cycle is 5 minutes, the system saves a performance data to a statistics file every 15 minutes.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] statistics-cycle 5
Warning: All data of the statistics task will be deleted. Continue? [Y/N]: y
[*HUAWEI-pm-statistics-task1] record-interval 3
Warning: This operation will cause some data to be lost. Continue? [Y/N]: y

reset pm current-data

Function

The reset pm current-data command deletes the collected performance statistics.

Format

reset pm current-data [ instance-type instance-type [ measure measure-name | instance instance-name &<1-8> ] * ]

Parameters

Parameter Description Value
instance-type instance-type

Deletes the performance statistics about instances of a specified type.

If instance-type instance-type is not specified, the system deletes the performance statistics about instances of all types.

The enumerated values include:
  • card: collects statistics about memory usage, CPU usage, and temperature of a device.

  • interface: collects traffic statistics on an interface.

  • nqa: collects network performance data.

  • ipfpm: collects IP FPM performance statistics.

NOTE:

Only the CE6880EI supports ipfpm.

measure measure-name Deletes the performance statistics about a specified counter.

The value is a string of 1 to 63 case-insensitive characters without spaces. Select statistics counters according to the device configuration.

instance instance-name Deletes the performance statistics about a specified instance.
The value is a string of 1 to 255 case-insensitive characters.
  • If instance-type is set to card, the value of instance-name is master, slave, or slot slot-id, for example, slot1.

  • If instance-type is set to interface, the value of instance-name is interface type interface number, for example, 10ge1/0/1 and eth-trunk2

  • If instance-type is set to nqa, the value of instance-name is admin-name-test-name, for example, admin-nqatest. The admin-name and test-name are configured using the nqa test-instance admin-name test-name command.

  • When instance-type is ipfpm, the instance-name value is configured using the instance (IPFPM-MCP view) instance-id command.

Views

Performance statistics collection task view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To delete the collected performance statistics and collect new performance statistics, run the reset pm current-data command.

Precautions

Performance statistics cannot be restored after being deleted. Confirm your action before using this command.

Example

# Delete the collected performance statistics.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] reset pm current-data
Related Topics

retry

Function

The retry command sets the number of retransmissions for a performance statistics file.

The undo retry command restores the number of retransmissions for a performance statistics file to the default value.

The default number of retransmissions for a performance statistics file is 3.

Format

retry retry-times

undo retry

Parameters

Parameter Description Value
retry-times Sets the number of retransmissions for a performance statistics file. The value is an integer ranging from 1 to 3. The default value is 3.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

The system generates performance statistics files and transmits these files to a PM server. To set the number of retransmissions for a performance statistics file, run the retry command.

Example

# Set the number of retransmissions for a performance statistics file to 2.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server server1
[~HUAWEI-pm-server-server1] retry 2
Related Topics

sample-interval

Function

The sample-interval command configures the sampling interval for a performance statistics task.

The undo sample-interval command restores the default setting.

By default, the sampling interval varies with the performance statistics interval as follows:

  • If the interval at which the performance statistics are collected is 5 minutes, the default sampling interval is 1 minute.
  • If the interval at which the performance statistics are collected is 10 minutes, the default sampling interval is 2 minutes.
  • If the interval at which the performance statistics are collected is 15 minutes, the default sampling interval is 3 minutes.
  • If the interval at which the performance statistics are collected is 30 minutes, the default sampling interval is 5 minutes.
  • If the interval at which the performance statistics are collected is 60 minutes, the default sampling interval is 5 minutes.
  • If the interval at which the performance statistics are collected is 1440 minutes, the default sampling interval is 15 minutes.

Format

sample-interval interval

undo sample-interval

Parameters

Parameter Description Value
interval Specifies the interval at which the performance statistics collected in a performance statistics task is sampled.

The value can be 1, 2, 3, 5, 10, 15, 30, or 60, in minutes:

  • If the interval at which performance statistics are collected is 5 minutes, the sampling interval is 1 minute by default and can be set to 1 minute or 5 minutes.
  • If the interval at which performance statistics are collected is 10 minutes, the sampling interval is 2 minutes by default and can be set to 1, 2, 5, or 10 minutes.
  • If the interval at which performance statistics are collected is 15 minutes, the sampling interval is 3 minutes by default and can be set to 1, 3, 5, or 15 minutes.
  • If the interval at which performance statistics are collected is 30 minutes, the sampling interval is 5 minutes by default and can be set to 1, 2, 3, 5, 10, 15, or 30 minutes.
  • If the interval at which performance statistics are collected is 60 minutes, the sampling interval is 5 minutes by default and can be set to 1, 2, 3, 5, 10, 15, 30, or 60 minutes.
  • If the interval at which performance statistics are collected is 1440 minutes, the sampling interval is 15 minutes by default and can be set to 1, 2, 3, 5, 10, 15, 30, or 60 minutes.

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

After the statistics task is configured, the system collects statistics at a specified sampling interval. The shorter the sampling interval, the more accurate the statistics. However, more system resources are consumed.

Example

# Set the sampling interval to 5 minutes.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] sample-interval 5
Related Topics

statistics enable

Function

The statistics enable command enables the performance statistics function.

The undo statistics enable command disables the performance statistics function.

By default, the performance statistics function is disabled.

Format

statistics enable

undo statistics enable

Parameters

None

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To collect performance statistics, run the statistics enable command to enable the performance statistics function.

Precautions

After the undo statistics enable command is run, the performance statistics task that is running will be stopped. Therefore, exercise caution when you run this command.

Example

# Enable the performance statistics function.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics enable
Related Topics

statistics-cycle

Function

The statistics-cycle command configures the performance statistics collection interval for a performance statistics task.

The undo statistics-cycle command restores the default setting.

The default interval is 15 minutes.

Format

statistics-cycle cycle

undo statistics-cycle

Parameters

Parameter Description Value
cycle Specifies the performance statistics collection interval for a performance statistics task.

The value can be 5, 10, 15, 30, 60, or 1440, in minutes. The default value is 15 minutes.

The system defines the interval 1440 minutes as a long interval and the interval 5, 10, 15, 30, or 60 minutes as a short interval.

Views

Performance statistics task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A specific performance statistics collection interval is set for each performance statistics task. After the performance statistics collection interval is set, bind an instance to the performance statistics task and enable statistics counter measurement so that the system can collect performance statistics at the specified interval. If the statistics interval is set to a small value, the obtained performance statistics are more accurate but more system resources are consumed.

Configuration Impact

Running the statistics-cycle command in the performance statistics task view has the following impacts:
  • Performance statistics of the performance statistics task are deleted.
  • The default interval at which the system generates performance statistics files is used. In the case of a short statistics collection interval, the system generates a performance statistics file every four performance statistics collection intervals; in the case of a long statistics collection interval, the system generates a performance statistics file every one performance statistics collection interval.

Example

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

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[~HUAWEI-pm-statistics-task1] statistics-cycle 5
Warning: All data of the statistics task will be deleted. Continue? [Y/N]: y
Related Topics

statistics-task

Function

The statistics-task command creates a performance statistics task or displays the performance statistics task view.

The undo statistics-task command deletes a performance statistics task.

By default, no performance statistics task is created.

Format

statistics-task task-name

undo statistics-task task-name

Parameters

Parameter Description Value
task-name Specifies the name of a performance statistics task.

The value is a string of 1 to 31 case-insensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A performance statistics task is the minimum statistics collection unit of PM. Before configuring the performance statistics function, run the statistics-task command to create a performance statistics task. Only one performance statistics collection interval can be configured for each performance statistics task. After a performance statistics task is configured, enable statistics counter measurement for the task.

Precautions

  • A maximum of 16 performance statistics tasks can be configured.

  • After the undo statistics-task command is run to delete a performance statistics task, performance statistics and performance statistics files of the task are deleted.

Example

# Configure a performance statistics task named task1.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] statistics-task task1
[*HUAWEI-pm-statistics-task1]
Related Topics

upload

Function

The upload command configures the device to upload performance statistics files to a PM server.

Format

upload request-name file filename &<1-16>

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files. The name of a request must already exist.
file filename

Specifies the name of a performance statistics file.

By default, performance statistics files are saved to the path flash:/pmdata.

The name of a performance statistics file must already exist.

Views

PM view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The system periodically generates performance statistics files based on the collected performance statistics. You can manually upload the statistics files to a PM server.

Prerequisites

A request for uploading performance statistics files to the PM server has been created using the upload-config request-name server server-name command.

Example

# Configure the device to upload performance statistics file to the PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server ftpserver
[*HUAWEI-pm-server-ftpserver] quit
[*HUAWEI-pm] upload-config req1 server ftpserver
[*HUAWEI-pm] commit
[~HUAWEI-pm] upload req1 file stream20130703103001.txt
Related Topics

upload auto

Function

The upload auto command enables a device to automatically upload performance statistics files to a server.

The undo upload auto command disables a device from automatically uploading performance statistics files to a server.

By default, a device does not automatically upload performance statistics files to a server.

Format

upload auto request-name

undo upload auto

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files to a server.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

Views

Performance statistics collection task view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The system periodically generates performance statistics files based on the collected performance statistics. To enable the device to automatically upload performance statistics files to the PM server at a specific interval, run the upload auto command.

Prerequisites

A request for uploading performance statistics files to the PM server has been created using the upload-config request-name server server-name command.

Example

# Configure the device to automatically upload statistics files to a PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server ftpserver
[*HUAWEI-pm-server-ftpserver] quit
[*HUAWEI-pm] upload-config req1 server ftpserver
[*HUAWEI-pm] statistics-task task1
[*HUAWEI-pm-statistics-task1] upload auto req1
Related Topics

upload-config

Function

The upload-config command creates a request for uploading performance statistics files to a specified PM server.

The undo upload-config command deletes a request for uploading performance statistics files to a specified PM server.

By default, no request for uploading performance statistics files is available on a device.

Format

upload-config request-name server server-name

undo upload-config request-name

Parameters

Parameter Description Value
request-name Specifies the name of a request for uploading performance statistics files.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The string contains letters, digits, and underscores (_), and must start with letters or digits.

server server-name Specifies the name of the process serving the PM server. The name of the process serving the PM server must already exist.

Views

PM view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable a device to upload performance statistics files to a PM server, run the upload-config command to create a file uploading request.

Prerequisites

A PM server process has been created using the pm-server server-name command.

Follow-up Procedure

Enable the device to upload performance statistics files to the PM server.

  • Run the upload request-name file filename &<1-16> command in the PM view to manually upload statistics files to the PM server.

  • Run the upload auto request-name command in the performance statistics collection task view to configure the device to automatically upload statistics files to the PM server.

Example

# Create a request for uploading statistics files to a PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server ftpserver
[*HUAWEI-pm-server-ftpserver] quit
[*HUAWEI-pm] upload-config req1 server ftpserver

username password

Function

The username password command configures the user name and password for logging in to the PM server.

The undo username command deletes the user name and password for logging in to the PM server.

By default, no user name and password for logging in to the PM server are configured.

Format

username user-name password password

undo username

Parameters

Parameter Description Value
user-name Specifies the user name for logging in to a PM server. The name is a string of 1 to 255 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
password Specifies the password for logging in to a PM server.
The value is a string of 1 to 128 characters or a string of 32 to 200 characters. The password can be in plain or cipher text.
  • The password in plain text is a string of 1 to 128 case-sensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
  • The password in cipher text is a string of 32 to 200 characters.

The password is displayed in ciphertext in the configuration file regardless of whether it is input in plaintext or cipher text.

Views

PM server view

Default Level

2: Configuration level

Usage Guidelines

To log in to a PM server for upload performance statistics files to the PM server, run the username password command to configure the user name and password.

Example

# Configure the user name and password for logging in to the PM server.

<HUAWEI> system-view
[~HUAWEI] pm
[~HUAWEI-pm] pm-server server1
[~HUAWEI-pm-server-server1] username admin password Pwd@123
Related Topics
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 69475

Downloads: 374

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next