The trace access-user object calling-number command creates service tracing objects, and specifies the location to which tracing information is output and the aging time of tracing information. Five objects can be traced at the same time.
By default, tracing information is output to the buffer of the local memory, and the tracing time is 15 minutes.
This command is supported only on the NetEngine 8000 F1A.
Parameter | Description | Value |
---|---|---|
output |
Indicates the location to which tracing information is output. |
- |
file file-name |
Indicates that tracing information is output to the file. file-name: specifies the name of the file that stores tracing information. |
The value is a string of 1 to 63 characters. |
syslog-server ipv4-address |
Indicates that tracing information is output to a log server. |
ip-address specifies the IP address of a log server, in dotted decimal notation. |
vty |
Indicates that tracing information is output to the VTY terminal. |
- |
mode |
The tracing mode. |
- |
packet |
Configures the tracing mode as packet. In packet mode, only packet exchange information is displayed, and the exchange information of the internal modules is not displayed. |
By default, all information of the object being traced is displayed. |
-t integer-value |
Sets the tracing time. |
The value is an integer ranging from 0 to 60, in minutes. If the value is 0, it indicates that the object is being traced all the time. |
include |
Indicates a fuzzy match is performed for text of calling number. If this parameter is not specified, an exact match is performed. |
- |
calling-number-content string-value |
Creates the trace object according to calling number. |
The value is a string of 1 to 253 characters. |
object object-id |
Specifies the ID of an object to be traced. |
The value is an integer ranging from 1 to 5. |
Usage Scenario
Before tracing a service, you must make sure that the service is accessed; otherwise, no tracing information is output. In addition, you need to make sure that the CPU usage on the Main Processing Unit does not exceed 70%.
Before outputting tracing information to a log server, you must make sure that the log server exists and is properly configured.Precautions
This command is used for fault diagnosis only. It consumes a great number of resources when the device is running normally and may affect services.
Recreate tracing objects after board restart or master/slave switchover.