Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Guide That Contains This Content
[+] Expand All
[-] Collapse All

    traceoptions (Exception Handling)


    traceoptions {file filename {files files;match match;size size;(no-world-readable | world-readable);}flag {flag;}level level;no-remote-trace;}

    Hierarchy Level

    [edit unified-edge gateways ggsn-pgw gateway-name software-datapath]

    Release Information

    Statement introduced in Junos OS Mobility Release 11.2W.


    Define tracing operations for exception handling.


    file filename—Name of the file that receives the output of the tracing operation. All files are placed in the /var/log directory.

    files files— (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 must also specify a maximum file size with the size option and a filename.

    Range: 2 through 1000

    Default: 3 files


    • flag—You can use one of the following flags:
      • ager—Trace flow ageout-related events.
      • all—Trace everything.
      • commands—Trace operational commands.
      • configuration—Trace configuration commands.
      • flow—Trace flow.
      • commands—Trace operational commands.
      • init—Trace events related to the init datapath daemon .
      • ipv6-router-advertisement—Trace IPv6 router advertisements.
      • memory—Trace memory.
      • reassembly—Trace reassembly.
      • redundancy—Trace redundancy.

    level level—(Optional) Level of tracing to perform. You can specify any of the following levels:

    • all—Match all levels.
    • error—Match error conditions.
    • info—Match informational messages.
    • notice—Match conditions that should be handled specially
    • verbose—Match verbose messages.
    • warning—Match warning messages.

    match match—(Optional) Refine the output to include lines that contain the regular expression.

    no-remote-trace—(Optional) Disable remote tracing.

    no-world-readable—(Optional) Restrict access to the originator of the trace operation only.

    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 must also specify a maximum number of trace files with the files option and filename.

    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—(Optional) Enable unrestricted file access.

    Required Privilege Level

    interface—To view this statement in the configuration.

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

    Published: 2011-11-16