Configuring System Logging for a Routing Matrix

This section explains how to configure system logging for the T640 Internet routing nodes and TX Matrix platform in a routing matrix. It assumes you are familiar with system logging for single-chassis systems, as described in Configuring System Logging for a Single-Chassis System.

To configure system logging for all platforms in a routing matrix, include the syslog statement at the [edit system] hierarchy level on the TX Matrix platform. The syslog statement applies to every platform in the routing matrix.

[edit system]

syslog {

    archive {

        files number;

        size size;

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

    }

    console {

        facility severity;

    }

    file filename {

        facility severity;

        explicit-priority;

        match "regular-expression";

        archive {

            files number;

            size size;

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

        }

    }

    host (hostname | other-routing-engine | scc-master) {

        facility severity;

        explicit-priority;

        facility-override facility;

        log-prefix string;

        match "regular-expression";

    }

    source-address source-address;

    time-format (year | millisecond | year millisecond);

    user (username | *) {

        facility severity;

        match "regular-expression";

    }

}

When included in the configuration on the TX Matrix platform, the following configuration statements have the same effect as on a single-chassis system, except that they apply to every platform in the routing matrix:

• archive—Configures the archiving of log files on each platform in the routing matrix. See Configuring Log File Archiving.
• console—Directs the specified messages to the console of each platform in the routing matrix. See Directing Messages to the Console.
• file—Directs the specified messages to a file of the same name on each platform in the routing matrix. See Directing Messages to a Log File.
• match—Limits the set of messages logged to a destination to those that contain (or do not contain) a text string matching a regular expression. See Using Regular Expressions to Refine the Set of Logged Messages.

The separate match statement at the [edit system syslog host scc-master] hierarchy level applies to messages forwarded from the T640 routing nodes to the TX Matrix platform. See Configuring Optional Features for Forwarded Messages.

• source-address—Sets the source address used for messages directed to the remote machines specified in all host hostname statements at the [edit system syslog] hierarchy level for each platform in the routing matrix. The address is not used for messages directed to the other Routing Engine on each platform or to the TX Matrix platform from the T640 routing nodes. See Specifying an Alternative Source Address for System Log Messages.
• time-format—Adds the millisecond, year, or both to the timestamp in each message. See Including the Year or Millisecond in Timestamps.
• user—Directs the specified messages to the terminal session of one or more specified users on each platform in the routing matrix that they are logged in to. See Directing Messages to a User Terminal.

The effect of the other statements differs somewhat for a routing matrix than for a single-chassis system. For more information, see the following sections:

• Configuring Message Forwarding in the Routing Matrix
• Configuring Optional Features for Forwarded Messages
• Directing Messages to a Remote Destination from the Routing Matrix
• Configuring System Logging Differently on Each Platform