Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

traceoptions (OVSDB)

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 Open vSwitch Database (OVSDB) management protocol, which is supported on Juniper Networks devices.

Default

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

Options

file filename

Name of file in which the system places the output of the tracing operations. By default, the system places all files in the /var/log directory.

  • Default: /var/log/vgd
files number

(Optional) Maximum number of trace files. When a trace file reaches the size specified by the size option, the filename is appended with 0 and compressed. For example, a trace file named trace-file.gz would be renamed trace-file.0.gz. When trace-file.0.gz reaches the specified size, it is renamed trace-file.1.gz and its contents are compressed to trace-file.0.gz. 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 also must specify a maximum file size with the size option and a filename.

  • Range: 2 through 1000 files

  • Default: 10 files
flag flag

Tracing operation to perform. You can include one or more of the following flags:

all

All OVSDB events.

configuration

OVSDB configuration events.

core

OVSDB core events.

function

OVSDB function events.

interface

OVSDB interface events.

l2-client

OVSDB Layer 2 client events.

netconf-client

(QFX Series switches only) Events for the dynamic configuration of Virtual Extensible LANs (VXLANs).

ovs-client

OVSDB client events.

match regular-expression

(Optional) Only log 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 passed through the Juniper Networks device.

no-world-readable

Restrict access to the trace files to the owner.

  • Default: no-world-readable
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 by using the files option and a filename by using the file option.

  • 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

Enable any user to access the trace files.

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 14.1R2.