Technical Documentation

Configuring Optional Features for Forwarded Messages on a TX Matrix Plus Router

To configure additional optional features when specifying how the T1600 routers forward messages to the TX Matrix Plus router, include statements at the [edit system syslog host sfc0-master] hierarchy level. To include priority information (facility and severity level) in each forwarded message, include the explicit-priority statement. To insert a text string in each forwarded message, include the log-prefix statement. To use regular expression matching to specify more exactly which messages from a facility are forwarded, include the match statement.

[edit system syslog]host sfc0-master {facility severity;explicit-priority;log-prefix string;match "regular-expression;}

You can also include the facility-override statement at the [edit system syslog host sfc0-master] hierarchy level, but we do not recommend doing so. It is not necessary to use alternative facilities for messages forwarded to the TX Matrix Plus router, because it runs the JUNOS system logging utility and can interpret the JUNOS Software–specific facilities. For more information about alternative facilities, see Changing the Alternative Facility Name for Remote System Log Messages.

  1. Including Priority Information in Forwarded Messages
  2. Adding a Text String to Forwarded Messages
  3. Using Regular Expressions to Refine the Set of Forwarded Messages

Including Priority Information in Forwarded Messages

When you include the explicit-priority statement at the [edit system syslog host sfc0-master] hierarchy level, messages forwarded to the TX Matrix Plus router include priority information. For the information to appear in a log file on the TX Matrix Plus router, you must also include the explicit-priority statement at the [edit system syslog file filename] hierarchy level for the file on the TX Matrix Plus router. As a consequence, the log file with the same name on each platform in the routing matrix also includes priority information for locally generated messages.

To include priority information in messages directed to a remote machine from all routers in the routing matrix, also include the explicit-priority statement at the [edit system syslog host hostname] hierarchy level for the remote machine. For more information, see Directing Messages to a Remote Destination from the Routing Matrix Based on a TX Matrix Plus Router.

In the following example, the /var/log/messages file on all routers includes priority information for messages with severity notice and higher from all facilities. The log on the TX Matrix Plus router also includes messages with those characteristics forwarded from the T1600 routers.

[edit system syslog]host sfc0-master {any notice;explicit-priority;}file messages {any notice;explicit-priority;}

Adding a Text String to Forwarded Messages

When you include the log-prefix statement at the [edit system syslog host sfc0-master] hierarchy level, the string that you define appears in every message forwarded to the TX Matrix Plus router. For more information, see Adding a Text String to System Log Messages.

Using Regular Expressions to Refine the Set of Forwarded Messages

When you include the match statement at the [edit system syslog host sfc0-master] hierarchy level, the regular expression that you specify controls which messages from the T1600 routers are forwarded to the TX Matrix Plus router. The regular expression is not applied to messages from the T1600 routers that are directed to destinations other than the TX Matrix Plus router. For more information about regular expression matching, see Using Regular Expressions to Refine the Set of Logged Messages.


Published: 2010-04-26