Cisco IOS XR System Monitoring Command Reference for the Cisco

Alarm Management and Logging Correlation Commands logging correlator apply rule

logging correlator apply rule

To apply and activate a correlation rule and enter correlation apply rule configuration mode, use the logging

correlator apply rule command in Global Configuration modeXR Config mode. To deactivate a correlation rule, use the no form of this command.

logging correlator apply rule correlation-rule [all-of-router| context name| location node-id]

no logging correlator apply rule correlation-rule [all-of-router| context name| location node-id]

Syntax Description correlation-rule all-of-router

context name

location node-id

Name of the correlation rule to be applied.

(Optional) Applies the correlation rule to the entire router.

(Optional) Applies the correlation rule to the specified context. Unlimited number of contexts. The name string is limited to 32 characters.

(Optional) Applies the correlation rule to the specified node. The node-id argument is entered in the rack/slot/module notation. Unlimited number of locations.

Command Default No correlation rules are applied.

Command Modes Global Configuration modeXR Config mode

Command History

Release

Release 3.6.0

Release 3.6.0

Release 3.7.2

Release 5.0.0

Modification

This command was introduced.

This command was introduced.

This command was introduced.

This command was introduced.

Usage Guidelines The logging correlator apply rule command is used to either add or remove apply settings for a given rule.

These settings then determine which messages are correlated for the affected rules.

If the rule is applied to all-of-router, then correlation occurs for only those messages that match the configured cause values for the rule to be correlated, regardless of the context or location setting of that message.

If a rule is applied to a specific set of contexts or locations, then correlation occurs for only those messages that match both the configured cause values for the rule and at least one of those contexts or locations.

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

17 OL-26517-02

Alarm Management and Logging Correlation Commands logging correlator apply rule

Task ID

Use the

show logging correlator rule, on page 56

command to show the current apply settings for a given rule.

Tip When a rule is applied (or if a rule set that contains this rule is applied), then the rule definition cannot be modified through the configuration until the rule or rule set is once again unapplied.

Tip It is possible to configure apply settings at the same time for both a rule and zero or more rule sets that contain the rule. In this case, the apply settings for the rule are the union of all the apply configurations.

The logging correlator apply rule command allows you to enter submode (config-corr-apply-rule) to apply and activate rules:

RP/0/0RP0RSP0/CPU0:router:hostname(config)# logging correlator apply rule stateful1

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)#?

all-of-router Apply the rule to all of the router clear clear commit

Clear the uncommitted configuration

Clear the configuration

Commit the configuration changes to running context describe do exit

Apply rule to specified context

Describe a command without taking real actions

Run an exec command

Exit from this submode location no pwd

Apply rule to specified location

Negate a command or set its defaults

Commands used to reach current submode root show

Exit to the global configurationXR Config mode

Show contents of configuration

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)#

While in the submode, you can negate keyword options:

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)# no all-of-router

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)# no context

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)# no location

Task ID logging

Operations read, write

Examples This example shows how to apply a predefined correlator rule to a location:

RP/0/0RP0RSP0/CPU0:router:hostname(config)# logging correlator apply rule rule1

RP/0/0RP0RSP0/CPU0:router:hostname(config-corr-apply-rule)# location 0/2/CPU0

Related Commands

Command

logging correlator rule, on page 25

show logging correlator rule, on page 56

Description

Defines the rules for correlating messages.

Displays one or more predefined logging correlator rules.

18

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Alarm Management and Logging Correlation Commands logging correlator apply rule

Command

show logging correlator ruleset, on page 59

Description

Displays one or more predefined logging correlator rule sets.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

19