traceoptions
Ethernet Switching Options
traceoptions {
file filename <files number> <no-stamp> <replace> <size size> <world-readable | no-world-readable>;
flag flag <disable>;
}
Ethernet Ring Protection
traceoptions {
file filename <no-stamp> <world-readable | no-world-readable> <replace> <size size>;
flag flag;
}
Edge Virtual Bridging
traceoptions {
file filename <files number> <no-stamp> <replace> <size size> <world-readable | no-world-readable>;
flag flag;
}
Hierarchy Level
[edit ethernet-switching-options]
[edit protocols protection-group]
[edit protocols edge-virtual-bridging]
Description
Define global tracing operations for access security features on Ethernet switches.
Configure trace options for the protection group.
Define global tracing operations for edge virtual bridging (EVB) features on Ethernet switches.
Default
The Ethernet Switching Options traceoptions feature is disabled by default.
Edge Virtual Bridging tracing operations are disabled by default.
Ethernet Ring Protection trace options are not set by default. On some EX Series switches, logging of basic ERPS state transitions is set by default. You can configure trace options on those switches to obtain more details than are provided by the default log. See Understanding Ethernet Ring Protection Switching Functionality for additional information about default logging of the basic state transitions.
Options
For Ethernet Switching Options:
disable—(Optional) Disable the tracing operation. You can use this option to disable a single operation when you have defined a broad group of tracing operations, such as all.
file filename —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.
files number —(Optional) Maximum number of trace files. When a trace file named trace-file 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 ( xk to specify KB, xm to specify MB, or xg to specify gigabytes), at which point the oldest trace file is overwritten. If you specify a maximum number of files, you also must specify a maximum file size with the size option.
Range: 2 through 1000
Default: 3 files
flag flag —Tracing operation to perform. To specify more than one tracing operation, include multiple flag statements. You can include the following flags:
access-security—Trace access security events.
all—All tracing operations.
analyzer—Trace analyzer events.
config-internal—Trace internal configuration operations.
filter—Trace filter transaction events.
forwarding-database—Trace forwarding database events.
general—Trace general events.
interface—Trace interface events.
krt—Trace communications over routing sockets.
lib—Trace library calls.
nexthop—Trace next-hop events.
normal—Trace normal events.
parse—Trace reading of the configuration.
regex-parse—Trace regular-expression parsing operations.
rtg—Trace redundant trunk group events.
state—Trace state transitions.
stp—Trace spanning-tree events.
task—Trace Ethernet-switching task processing.
timer—Trace Ethernet-switching timer processing.
unknown-unicast-forwarding—Trace unknown unicast forwarding events.
vlan—Trace VLAN events.
no-stamp—(Optional) Do not timestamp the trace file.
Default: If you omit this option, timestamp information is placed at the beginning of each line of the tracing output.
no-world-readable—(Optional) Restrict file access to the user who created the file.
replace—(Optional) Replace an existing trace file if there is one rather than appending to it.
Default: If you do not include this option, tracing output is appended to an existing trace file.
size size —(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes. When a trace file named trace-file 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 also must specify a maximum file size with the files option.
Syntax: xk to specify KB, xm to specify MB, or xg to specify gigabytes
Range: 10 KB through 1 gigabyte
Default: 128 KB
world-readable—(Optional) Enable unrestricted file access.
For Ethernet Ring Protection:
file filename—Name of the file to receive the output of the tracing operation. All files are placed in the directory /var/log. You can include the following file options:
no-stamp—(Optional) Do not timestamp trace file.
no-world-readable—(Optional) Do not allow any user to read the log file.
replace—(Optional) Replace the trace file rather than appending to it.
size—(Optional) Maximum trace file size (10240..4294967295).
world-readable—(Optional) Allow any user to read the log file.
flag flag—Tracing operation
to perform. To specify more than one tracing operation, include multiple flag statements. The following flags are available for both
EX Switches and MX Series routers:
all—Trace all
config —Trace configuration messages
debug—Trace debug messages
events—Trace events to the protocol state machine
normal—Trace normal messages
pdu —Trace RAPS PDU reception and transmission
periodic-packet-management—Trace periodic packet management state and events
state-machine—Trace RAPS state machine
timers—Trace protocol timers
For Edge Virtual Bridging:
file filename—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.
files number—(Optional) Maximum number of trace files. When a trace file named trace-file 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 (xk to specify KB, xm to specify MB, or xg to specify gigabytes), at which point the oldest trace file is overwritten. If you specify a maximum number of files, you also must specify a maximum file size with the size option.
Range: 2 through 1000
Default: 3 files
no-world-readable—(Optional) Restrict file access to the user who created the file.
replace—(Optional) Replace an existing trace file if there is one rather than appending output to it.
Default: If you do not include this option, tracing output is appended to an existing trace file.
size size—(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes. When a trace file named trace-file 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 also must specify a maximum file size with the files option.
Syntax: xk to specify KB, xm to specify MB, or xg to specify gigabytes
Range: 10 KB through 1 gigabyte
Default: 128 KB
world-readable—(Optional) Enable unrestricted file access.
flag flag—Tracing operation to perform. To specify more than one tracing operation, include multiple flag statements. You can include the following flags:
all—Trace everything.
ecp—Trace Edge Control Protocol (ECP) events.
evb-tlv— Trace EVB type, length, and value (TLV) events.
parse—Trace configuration parsing.
policy—Trace policy events.
vdp—Trace Virtual Station Interface (VSI) Discovery and Configuration Protocol (VDP) events.
Required Privilege Level
routing—To view this statement in the configuration.routing-control—To add this statement to the configuration.
system—To view this statement in the configuration.
system-control—To add this statement to the configuration.
Release Information
Statement introduced in Junos OS Release 11.1.
The traceoptions statement is not supported
on the QFX3000 QFabric system.