traceoptions (Protocols BMP)
Syntax
traceoptions {
file file-name <files number> <size size> <world-readable | no-world-readable>;
flag flag <flag-modifier> <disable>;
}
Hierarchy Level
[edit logical-systems logical-system-name routing-options bmp], [edit logical-systems logical-system-name routing-options bmp station station-name], [edit routing-options bmp], [edit routing-options bmp station station-name]
Description
Enabling tracing can adversely impact scale and performance and may increase security risk. We strongly recommend using the trace, tracing, or traceoptions commands only under the guidance of a JTAC support engineer. After collecting the debug information, immediately disable tracing to minimize risk and restore normal system performance.
Configure tracing options for BMP monitoring. To specify more than one tracing operation, include multiple flag statements.
Options
file file-name—Name of the file to receive the output of the tracing operation.
Enclose the name within quotation marks. All files are placed in the
directory /var/log. We recommend
that you place BMP tracing output in the file bmp-log.
files number—(Optional)
Maximum number of trace files. When a trace file named trace-file.0 reaches its maximum
size, it is renamed trace-file.0, then trace-file.1, and so on, until the maximum number of trace
files is reached. Then, the oldest trace file is overwritten. If you
specify a maximum number of files, you must also specify a maximum
file size with the size option.
Range: 2 through 1000 files
Default: 10 files
flag—Tracing operation
to perform. To specify more than one tracing operation, include multiple flag statements.
all—Trace all BMP monitoring operations.down—Down messages.error—Error conditions.event—Major events, station establishment, errors, and events.general—General events.normal—Normal events.packets—All messages.policy—Policy processing.route—Routing information.route-monitoring—Route monitoring messages.state—State transitions.statistics—Statistics messages.task—Routing protocol task processing.timer—Routing protocol timer processing.up—Up messages.write—Writing of messages.
flag-modifier—(Optional)
Modifier for the tracing flag. You can specify one or more of these
modifiers:
detail—Provide detailed trace information.disable—Disable the tracing flag.receive—Trace the packets being received.send—Trace the packets being transmitted.
no-world-readable—(Optional) Prevent any user
from reading the log file.
size size—(Optional) Maximum
size of each trace file, in kilobytes (KB), megabytes (MB),
or gigabytes (GB). When a trace file named trace-file reaches this size, it is renamed trace-file.0. When the trace-file again reaches its
maximum size, trace-file.0 is renamed trace-file.1 and trace-file is renamed trace-file.0. This renaming scheme continues until the maximum number of trace
files is reached. Then, the oldest trace file is overwritten. If you
specify a maximum file size, you also must specify a maximum number
of trace files with the files option.
Syntax:
xkto specify KB,xmto specify MB, orxgto specify GB
Range: 10 KB through the maximum file size supported on your system
Default: 128 KB
world-readable—(Optional) Allow any user to
read the log file.
Required Privilege Level
routing and trace—To view this statement in the configuration.
routing-control and trace-control—To add this statement to the configuration.
Release Information
Statement introduced in Junos OS Release 13.2X51-D15.