Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

traceoptions (Protocols OpenFlow)

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

Default

If you do not include this statement, no OpenFlow-specific tracing operations are performed.

Options

file filename

Name of the file to receive the output of the tracing operation. All files are placed in the /var/log directory.

  • Default: /var/log/ofd
files number

(Optional) Maximum number of trace files. When a trace file named trace-file reaches its maximum size, it is renamed and compressed to trace-file.0.gz. When trace-file again reaches its maximum size, trace-file.0.gz is renamed trace-file.1.gz, and trace-file is renamed and compressed to trace-file.0.gz. This renaming scheme continues until the maximum number of trace files is reached. After this, the oldest trace file is overwritten.

If you specify a maximum number of files, you also must specify a maximum file size by using the size option and also a filename.

  • Range: 2 through 1000 files

  • Default: 10 files
flag flag

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

  • all—All OpenFlow events.

  • barrier—OpenFlow barrier events.

  • configuration—OpenFlow configuration events.

  • filter—OpenFlow filter events.

  • flow—OpenFlow flow events.

  • function—OpenFlow entry and exit events.

  • group—(Appears only for Juniper Networks devices running OpenFlow v1.3.1 or later) OpenFlow group events.

  • interface—OpenFlow interface events.

  • nh—OpenFlow next-hop events.

  • packet-io—OpenFlow packet in and packet out events.

  • packets—OpenFlow packet events.

  • statistics—OpenFlow statistics request and reply events.

  • switch—OpenFlow switch events including controller connection messages and keepalives, and packets sent to and received from the controller.
match regular-expression

(Optional) Log only those lines that match the regular expression.
no-remote-trace

(Optional) Disable tracing and logging operations that track normal operations, error conditions, and packets that are generated by or have passed through the Juniper Networks device.

no-world-readable

(Optional) Disable unrestricted file access, which restricts file access to the owner. This is the default.
size size

(Optional) Maximum size of each trace file in bytes, kilobytes (KB), megabytes (MB), or gigabytes (GB). If you do not specify a unit, the default is bytes. If you specify a maximum file size, you also must specify a maximum number of trace files with the files option and a filename.

  • Syntax: size to specify bytes, sizek to specify KB, sizem to specify MB, or sizeg to specify GB

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

  • Default: 128 KB
world-readable

(Optional) Enable unrestricted file access.

Required Privilege Level

admin—To view this statement in the configuration.

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

Release Information

Statement introduced in Junos OS Release 13.3.

Related Documentation