Syntax
traceoptions {
file {
filename;
files number;
match regular-expression;
size maximum-file-size;
(world-readable | no-world-readable);
}
flag flag;
no-remote-trace;
packet-filter filter-name {
conn-tag session-conn
destination-port port-identifier;
destination-prefix address;
interface interface-name;
protocol protocol-identifier;
source-port port-identifier;
source-prefix address;
}
rate-limit messages-per-second;
trace-level (brief | detail | error);
}
Hierarchy Level
[edit services service-set name flow]
Description
Configure flow tracing options for
a service-set.
Options
file |
Configure the
trace file options.
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 . By default, the name of the file is the name of the
process being traced.
|
files number |
Maximum number of trace files. When a trace file named trace-file reaches its maximum size, it
is renamed to trace-file.0 , then trace-file.1 , and so on, until the maximum
number of trace files is reached. The oldest archived file is overwritten.
If you specify a maximum number of files, you also must specify
a maximum file size with the size option and a filename.
|
match regular-expression |
Refine the output to include lines that
contain the regular expression.
|
size maximum-file-size |
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 and
a filename.
Syntax: x K to specify KB, x m to specify MB, or x g to specify GB
Range: 0 KB through 1 GB
Default: 128 KB
|
world-readable | no-world-readable |
By default, log files can be accessed only by the
user who configures the tracing operation. The world-readable option enables any user to read the file. To explicitly set the
default behavior, use the no-world-readable option.
|
|
flag |
Trace operation
to perform. To specify more than one trace operation, include multiple flag statements.
all |
Trace with all
flags enabled
|
basic-datapath |
Trace
basic packet flow activity
|
fragmentation |
Trace
IP fragmentation and reassembly events
|
high-availability |
Trace
flow high-availability information
|
host-traffic |
Trace
flow host traffic information
|
multicast |
Trace multicast
flow information
|
route |
Trace route lookup
information
|
session |
Trace session
creation and deletion events
|
session-scan |
Trace
session scan information
|
tcp-basic |
Trace TCP
packet flow information
|
tunnel |
Trace tunnel
information
|
|
no-remote-trace |
Set
remote tracing as disabled.
|
packet-filter filter-name |
Packet filter to enable during the tracing
operation. Configure the filtering options.
destination-port port-identifier |
Match TCP/UDP destination port
|
destination-prefix address |
Destination IP address prefix
|
interface interface-name |
Logical interface
|
protocol protocol-identifier |
Match IP protocol type
|
source-port port-identifier |
Match TCP/UDP source port
|
source-prefix address |
Source IP address prefix
|
|
rate-limit messages-per-second |
Limit the incoming rate of trace messages.
|
trace-level |
Set the
level for trace logging. This option is available only when the flag
is set.
brief |
Trace key flow
information, such as message types sent between SPU and central point,
policy match, and packet drop reasons.
|
detail |
Trace extensive
flow information, such as detailed information about sessions and
fragments. Detail is the default level.
|
error |
Trace error information,
such as system failure, unknown message type, and packet drop.
|
|
Required Privilege Level
trace—To view this in the configuration.
trace-control—To
add this to the configuration.
Release Information
Statement
introduced in Junos OS Release 20.3R1.