traceoptions (Extensions)

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.

Trace options for extension-service applications. You can set the traceoptions statement for the application level or for the file script-name level or for both. If the traceoptions statement is set for both the application and file script-name levels, the latter will have a higher priority.

Note:

Global traceoptions for daemonized applications do not take effect if the daemonized application and global traceoptions are committed separately

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 maximum number of trace files. Range: 2 through 1000 Default: 3
`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: 10240 through 1073741824 Default: 128k
`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 all operations.
`config`	Trace important events.
`general`	Trace script input data.
`grpc`	Trace grpc server events.
`notification`	Trace notification events.
`routing-socket`	Trace routing socket calls.
`timeouts`	Trace timeouts.
`timer`	Trace internal timer events.

no-remote-trace

Disable remote tracing. This option is valid only when [system tracing] is configured.

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.

ON THIS PAGE