Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

traceoptions (PCEF)

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.

Specify tracing options for policy and charging enforcement functions (PCEF).

Options

file file-name

Use the specified name of the file to receive the output of the tracing operation.
files number

(Optional) Use the specified 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.

  • Range: 2 through 1000

  • Default: 3 files
flag flag

Specify which operations are to be traced. To specify more than one operation, include multiple flag statements.

Best Practice:

You might want to enable traceoptions only when you want to debug specific charging operations. Enabling the traceoption flags might have an impact on the system performance.

  • all—Trace all operations.

  • config—Trace configuration events.

  • debug—Trace debug internal events.

  • fsm—Trace finite state machine events.

  • general—Trace general events that do not fit in any specific traces.

  • high-availability—Trace high-availability events.

  • init—Trace initialization events.

  • tftmgr—Trace tftmgr events.
level

Use the specified level of tracing. You can specify any of the following levels:

  • all—Match all levels.

  • critical—Match critical conditions.

  • error—Match error conditions.

  • info—Match informational messages

  • notice—Match conditions that must be handled specially.

  • verbose—Match verbose messages.

  • warning—Match warning messages.
no-remote-trace

(Optional) Disable remote tracing.
no-world-readable

(Optional) Disable unrestricted file access.
size size

(Optional) Use the specified maximum size of each trace file, in kilobytes (KB) or megabytes (MB). 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 number of files, you must also specify a maximum file size with the size option.

  • Syntax: xk to specify KB, xm to specify MB, or xg to specify GB.

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

  • Default: 128 KB
word-readable

(Optional) Enable unrestricted file access.

Required Privilege Level

trace and unified-edge—To view this statement in the configuration.

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

Release Information

Statement introduced in Junos OS Release 17.1.

Related Documentation