traceoptions (Services Logging)
Syntax
traceoptions { file filename <files number> <match regular-expression> <size size> <world-readable | no-world-readable>; flag flag; no-remote-trace; }
Hierarchy Level
[edit services adaptive-services-pics], [edit services logging]
Description
Configure Adaptive Services or Multiservices PIC tracing operations. The messages are output to /var/log/serviced.
Options
file filename
—Name of the file to receive the output of the tracing operation.
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 files
Default: 3 files
flag flag
—Tracing operation
to perform:
all
—Trace everything.
command-queued
—Trace command enqueue events.
config
—Trace configuration events.
handshake
—Trace handshake events.
init
—Trace initialization events.
interfaces
—Trace interface events.
mib
—Trace GGSN SNMP MIB events.
removed-client
—Trace client cleanup events.
show
—Trace CLI command servicing.
match regex
—(Optional)
Match output to a defined regular expression (regex).
Default: If you do not include this option, the trace operation output includes all lines relevant to the logged events.
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:
xk
to specify KB,xm
to specify MB, orxg
to specify GB
Range: 10 KB through 1 GB
Default: 128 KB
world-readable
—(Optional) Allow any user to
read the log file.
Required Privilege Level
interface—To view this statement in the configuration.
interface-control—To add this statement to the configuration.
Release Information
Statement introduced before Junos OS Release 7.4.
file
option added in Release 8.0.