Contents

System debugging commands· 1

debugging· 1

debugging-auto-off enable cpu-usage-alarm·· 2

display debugging· 2

display debugging-auto-off 3

 

System debugging commands

debugging

Use debugging to enable debugging for a module.

Use undo debugging to disable debugging for a module or for all modules.

Syntax

debugging module-name [ option ]

undo debugging { all | module-name [ option ] }

Default

Debugging is disabled for all modules.

Views

User view

Predefined user roles

network-admin

Parameters

module-name: Specifies a module by its name, such as arp or device. For a list of supported modules, use the debugging ? command.

option: Specifies the debugging option for a module. Available options vary by module. To display the debugging options supported by a module, use the debugging module-name ? command.

all: Specifies all modules.

Usage guidelines

	CAUTION: Output of excessive debugging messages increases the CPU usage and downgrades the system performance. To guarantee system performance, enable debugging only for modules that are in an exceptional condition.

 

The system sends generated debug messages to the device information center, which then sends the messages to appropriate destinations based on the log output configuration. For more information about the information center, see System Management Configuration Guide.

For more information about the debugging commands and debugging information about a module, see debugging manuals of the module.

Examples

# Enable debugging for the device management module.

<Sysname> debugging dev

Related commands

display debugging

debugging-auto-off enable cpu-usage-alarm

Use debugging-auto-off enable cpu-usage-alarm to enable the debugging-auto-off feature to automatically disable all types of debugging when the CPU usage reaches or exceeds the lowest CPU usage alarm threshold.

Use undo debugging enable cpu-usage-alarm to disable the debugging-auto-off feature from automatically disabling all types of debugging when the CPU usage reaches or exceeds the lowest CPU usage alarm threshold.

Syntax

debugging-auto-off enable cpu-usage-alarm

undo debugging-auto-off enable cpu-usage-alarm

Default

The debugging-auto-off feature is not enabled.

Views

User view

Predefined user roles

network-admin

Usage guidelines

Excessive output from debugging commands might affect system performance. To guarantee system performance, enable the debugging-auto-off feature to automatically disable all types of debugging when the CPU usage reaches or exceeds the lowest CPU usage alarm threshold. The CPU usage alarm thresholds are set by using the monitor cpu-usage threshold command.

The device does not automatically enable all types of debugging after the CPU usage drops to or below the CPU usage recovery threshold. To enable debugging for a module or all modules, use the debugging command.

Examples

# Enable the debugging-auto-off feature to automatically disable all types of debugging when the CPU usage reaches or exceeds the lowest CPU usage alarm threshold.

<Sysname> debugging-auto-off enable cpu-usage-alarm

Related commands

display debugging-auto-off

monitor cpu-usage threshold (System Management Command Reference)

display debugging

Use display debugging to display the enabled debugging features for a module or for all modules.

Syntax

display debugging [ module-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

module-name: Specifies a module by its name. For a list of supported modules, use the display debugging ? command. If you do not specify a module name, this command displays the enabled debugging features for all modules.

Examples

# Display all enabled debugging features.

<Sysname> display debugging

DEV debugging switch is on

Related commands

Debugging

display debugging-auto-off

Use display debugging-auto-off to display the enabling status of the debugging-auto-off feature.

Syntax

display debugging-auto-off

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

To conserve system resources, the device automatically disables all types of debugging in the following situations:

·     All users have gone offline.

·     The CPU usage reaches or exceeds the lowest CPU usage alarm threshold.

The device always automatically disables all types of debugging when all users have gone offline. This mechanism is not user configurable.

To enable the device to automatically disable all types of debugging when the CPU usage reaches or exceeds the lowest CPU usage alarm threshold, use the debugging-auto-off enable cpu-usage-alarm command.

Examples

# Display the enabling status of the debugging-auto-off feature.

<Sysname> display debugging-auto-off

Occasions for the system to automatically turn off all debugging:

 When all users log out: Enabled

 When the CPU usage reaches or exceeds the CPU usage alarm threshold: Disabled

Table 1 Command output

Field	Description
Occasions for the system to automatically turn off all debugging	Situations where the device automatically disables all types of debugging.
When all users log out: Enabled	The debugging-auto-off feature is always enabled for the situation where all users have gone offline.
When the CPU usage reaches or exceeds the CPU usage alarm threshold: Enabled	The debugging-auto-off feature is enabled for the situation where the CPU usage reaches or exceeds the lowest CPU usage alarm threshold.
When the CPU usage reaches or exceeds the CPU usage alarm threshold: Disabled	The debugging-auto-off feature is disabled for the situation where the CPU usage reaches or exceeds the lowest CPU usage alarm threshold.

 

Related commands

debugging-auto-off enable cpu-usage-alarm