traceoptions (Virtual Chassis)

Syntax

Hierarchy Level

Description

Define tracing operations for the Virtual Chassis or VCF.

Each Virtual Chassis or VCF member is updated with configured tracing options, and the log file is stored locally on each device.

Note:

In a large-scale VCF, use system logging and tracing with discretion, and only for troubleshooting. These operations place an extra load on the primary Routing Engine device, which can impact VCF convergence time and stability. All tracing options should be disabled during normal VCF operation. To troubleshoot particular problems, selectively enable tracing options, and disable them again after collecting the desired information.

Default

Tracing operations are disabled.

Options

detail—(Optional) Generate detailed trace information for a flag.

Note:

Enable tracing at the detail level only while troubleshooting a particular issue, and disable it again for normal system operation.

disable—(Optional) Disable a flag.

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. 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 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:

all—All tracing operations.

Tip:
The all flag displays a subset of logs that are generally useful in debugging issues, and for more detailed information, you can use options all detail. However, to avoid significantly impacting VCF stability, use this high level of tracing only for troubleshooting for a short period of time, and not during normal VCF operation.
auto-configuration—Trace Virtual Chassis ports (VCPs) that have been automatically configured.
csn—Trace Virtual Chassis complete sequence number (CSN) packets.
error—Trace Virtual Chassis errored packets.
hello—Trace Virtual Chassis hello packets.
krt—Trace Virtual Chassis KRT events.
lsp—Trace Virtual Chassis link-state packets.
lsp-generation—Trace Virtual Chassis link-state packet generation.
me—Trace Virtual Chassis ME events.
normal—Trace normal events.
packets—Trace Virtual Chassis packets.
parse—Trace reading of the configuration.
psn—Trace partial sequence number (PSN) packets.
route—Trace Virtual Chassis routing information.
spf—Trace Virtual Chassis SPF events.
state—Trace Virtual Chassis state transitions.
task—Trace Virtual Chassis task operations.

no-stamp—(Optional) Do not place a timestamp on any trace file.

no-world-readable—(Optional) Restrict file access to the user who created the file.

receive—(Optional) Trace received packets.

replace—(Optional) Replace a trace file rather than appending information to it.

send—(Optional) Trace transmitted packets.

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 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 GB

Range: 10 KB through 1 GB

Default: 128 KB

world-readable—(Optional) Enable unrestricted file access.

Required Privilege Level

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 9.0.

Option detail added in Junos OS Release 9.2 for EX Series switches.