Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

traceoptions (Services)

Syntax

Hierarchy Level

Description

CAUTION:

Enabling tracing can adversely impact scale and performance and may increase security risk. We strongly recommend using the trace, tracing, or traceoptions commands only under the guidance of a JTAC support engineer. After collecting the debug information, immediately disable tracing to minimize risk and restore normal system performance.

Define tracing operations for the JET service process (jsd).

Options

file

Indicate trace file information.

filename

Name of the file to receive the tracing operation output. Enclose the name in quotation marks. Traceoption output files are located in the /var/log/ directory.
files number

(Optional) Specify the maximum number of trace files.

  • Range: 2 through 1000

  • Default: 10
match regex

Specify the regular expression for lines to be logged.
size size

(Optional) Specify the maximum size of each trace file. When a trace file named trace-file reaches its maximum size, it is renamed trace-file.0. The traceoption output continues in a second trace file named trace-file.1. When trace-file.1 reaches its maximum size, output continues in a third file named trace-file.2, and so on. When the maximum number of trace files is reached, the oldest trace file is overwritten.

  • Range: 10,240 through 1,073,741,824 bytes

  • Default: 1000k
world-readable | no-world-readable

(Optional). Grant all users permission to read log files, or restrict the permission only to the root user and users who have Junos OS maintenance permission.
flag flag

Specify the tracing operation to perform. To specify more than one tracing operation, include multiple flag statements:

  • all—Trace everything.

  • config—Trace configuration events.

  • general—Trace general events.

  • grpc—Trace grpc server events.

  • libgrpc-debug—(Junos OS Release 19.3R1 only) Trace all lib grpc-related events.

  • libgrpc-errors—(Junos OS Release 19.3R1 only) Trace lib grpc errors.

  • libgrpc-info—(Junos OS Release 19.3R1 only) Trace lib grpc info and errors.

  • notification—Trace notification events.

  • routing-socket—Trace routing socket calls

  • timeouts—Trace timeouts.

  • timer—Trace internal timer events.

Note:

The libgrpc trace flags are only supported in Junos OS Release 19.3R1. They allow you to see events from the grpc libraries in the jsd trace log. Within the grpc core there are multiple libraries (for example, iomgr, compression, and profiling).
level

Set the trace log verbosity. Use the error option to only show error events.
Note:

This error option does not apply to the libgrpc trace flags.
no-remote-trace

Disable remote tracing.

Required Privilege Level

trace—To view this statement in the configuration.

trace-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 16.1.

level option introduced in Junos OS Release 20.2R1.

Trace flag options libgrpc-debug, libgrpc-errors, and libgrpc-info are supported in Junos OS Release 19.3R1 only.