Tracing Global Routing Protocol Operations

Global routing protocol tracing operations track all general routing operations and record them in a log file. Any global tracing operations that you configure are inherited by the individual routing protocols. To modify the global tracing operations for an individual protocol, configure tracing when configuring that protocol.

For a general discussion about tracing and the precedence of multiple tracing operations, see the JUNOS System Basics Configuration Guide.

To configure global routing protocol tracing flags, include the traceoptions statement:

[edit routing-options]

traceoptions {

    file name <replace> <size size> <files number> <no-stamp> 

        <(world-readable | no-world-readable)>;

    flag flag <flag-modifier> <disable>; 

}

For a list of hierarchy levels at which you can configure this statement, see the statement summary section for this statement.

You can specify the following global routing protocol tracing flags:

• all—Trace all tracing operations.
• general—Trace all normal operations and routing table changes (a combination of the normal and route trace operations).
• normal—Trace all normal operations.
• policy—Trace policy operations and actions.
• route—Trace routing table changes.
• state—Trace state transitions.
• task—Trace interface transactions and processing.
• timer—Trace timer usage.

You can specify the following tracing flag modifiers:

• detail—Provide detailed trace information.
• receive—Trace only packets being received.
• send—Trace only packets being transmitted.
  

  NOTE: Use the traceoption flags detail and all with caution. These flags may cause the CPU to become very busy.

  
  

The flags in a traceoptions flag statement are identifiers. When you use the set command to configure a flag, any flags that might already be set are not modified. In the following example, setting the csn tracing flag has no effect on the already configured detail flag. Use the delete command to delete a particular flag.

[edit protocols isis]

user@host# show

traceoptions {

    flag csn detail;

}

[edit protocols isis]

user@host# set traceoptions flag csn

[edit protocols isis]

user@host# show

traceoptions {

    flag csn detail;

}

user@host# delete traceoptions flag detail

[edit protocols isis]

user@host# show

traceoptions {

    flag csn;

}

Examples: Tracing Global Routing Protocol Operations

Log all globally traceable operations, saving the output in up to 10 files that are up to 10 MB in size:

[edit]

routing-options {

    traceoptions {

        file routing size 10m files 10;

        flag all;

    }

}

Log all unusual or abnormal traceable operations:

[edit]

routing-options {

    traceoptions {

        file routing size 10m files 10;

        flag all;

        flag normal disable;

    }

}

Log changes that occur in the JUNOS software routing table:

[edit]

routing-options {

    traceoptions {

        file routing size 10m files 10;

        flag route;

    }

}