Cisco Systems 1000 Series Network Router User Manual


 
20-2
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 20 Tracing and Trace Management
Tracing cannot be disabled on the Cisco ASR 1000 Series Router. Trace levels, however, which set the
message types that generate trace output, are user-configurable and can be set using the platform trace
commands. If a user wants to modify the trace level to increase or decrease the amount of trace message
output, the user should set a new tracing level using the platform trace commands. Trace levels can be
set by process using the all-modules keyword within the platform trace commands, or by module
within a process. See the platform trace command reference for more information on this command,
and the “Tracing Levels” section on page 20-2 of this document for additional information on tracing
levels.
Tracing Levels
Tracing levels determine how much information about a module should be stored in the trace buffer or
file.
shows all of the trace levels that are available and provides descriptions of what types of messages are
displayed with each tracing level.
Trace level settings are leveled, meaning that every setting will contain all messages from the lower
setting plus the messages from its own setting. For instance, setting the trace level to 3(error) ensures
that the trace file will contain all output for the 0 (emergencies), 1 (alerts), 2 (critical), and 3 (error)
settings. Setting the trace level to 4 (warning) will ensure that all trace output for the specific module
will be included in that trace file.
The default tracing level for every module on the Cisco ASR 1000 Series Router is notice.
All trace levels are not user-configurable. Specifically, the alert, critical, and notice tracing levels cannot
be set by users. If you wish to trace these messages, set the trace level to a higher level that will collect
these messages.
Table 20-1 Tracing Levels and Descriptions
Trace Level Level Number Description
Emergency 0 The message is regarding an issue that makes the system unusable.
Alert 1 The message is regarding an action that must be taken
immediately.
Critical 2 The message is regarding a critical condition. This is the default
setting for every module on the Cisco ASR 1000 Series Routers.
Error 3 The message is regarding a system error.
Warning 4 The message is regarding a system warning
Notice 5 The message is regarding a significant issue, but the router is still
working normally.
Informational 6 The message is useful for informational purposes only.
Debug 7 The message provides debug-level output.
Verbose 8 All possible tracing messages are sent.
Noise - All possible trace messages for the module are logged.
The noise level is always equal to the highest possible tracing
level. Even if a future enhancement to tracing introduces a higher
tracing level, the noise level will become equal to the level of that
new enhancement.