Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

traceoptions (Services Logging)

Syntax

Hierarchy Level

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, or xg 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.