Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

traceoptions (Process Monitor)

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.

Enable tracing options for the process health monitor process (pmond).

Note:

Starting with Junos OS Release 15.1R2, the pmond process is enabled by default on the Routing Engines of MX Series routers, even when no service interfaces are configured.

Options

file filename

Name of the file to receive the output of the tracing operation. Enclose the name within quotation marks. To include the file statement, you must specify a filename.
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.
flag flag

Specify which tracing operation to perform. To specify more than one tracing operation, include multiple flag statements. You can include the following flags:

  • all—Enable all trace options flags.

  • events—Trace process state change and cleanup events.

  • gencfg—Trace GENCFG blobs recorded for cleanup.

  • module—Trace module code.

  • sysvsem—Trace SYSV semaphores recorded for cleanup.

  • sysvshm—Trace SYSV shared memory segments recorded for cleanup.

  • tracking—Trace tracking code.

  • ui—Trace user interface operations.

level level

Specify the level of debugging output:

  • all—Match all levels.

  • error—Match error conditions.

  • info—Match informational messages.

  • notice—Match conditions that warrant special handling (but are not errors).

  • verbose—Match verbose messages.

  • warning—Match warning messages.
match regex

(Optional) Refine the output to include lines that contain the regular expression.
no-remote-trace

Disable remote tracing.
size size

(Optional) Maximum size of each trace file, in kilobytes (KB), megabytes (MB), or gigabytes (GB). If you specify a maximum file size, you also must specify a maximum number of trace files with the files number 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 | 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 the Junos maintenance permission.

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 9.0.