Administer > Configure Incidents > Configure SNMP Trap Incidents > SNMP Trap Configuration Form > Configure Forward to Global Manager Settings for an SNMP Trap Incident (NNMi Advanced)

Configure Forward to Global Manager Settings for an SNMP Trap Incident (NNMi Advanced)

[This is the Context-Sensitive Help topic for the Incident Config: Forward to Global Managers Tab for all Incident Configurations.]

For information about each SNMP Traps  tab: Concept Link IconSee Also

(NNMi Advanced - Global Network Management feature) The NNMi Global Network Management feature enables multiple NNMi management servers to work together while managing different geographic areas of your network. See NNMi's Global Network Management Feature (NNMi Advanced) for more information. The Global Manager combines topology information from multiple Regional Managers, but maintains a separate set of incidents about those nodes.

Use the Global Manager Forwarding tab when you want to forward specific SNMP traps from your NNMi management server (a Regional Manager) to all Global Managers in your Global Network Management environment.

Caution The Global Manager must have an incident configuration for that SNMP trap, otherwise the incoming trap is dropped. See Export and Import Configuration Settings for ideas about sharing incident configurations among NNMi management servers.

When you configure Forward to Global Managers, you can specify an optional Payload Filter for NNMi to use when determining which occurrences should be forwarded to Global Managers. Payload Filters enable you to use the data that is included with an occurrence of an incident configuration before it is stored as an incident in the NNMi database.

Examples of the type of data that can be used as a Payload Filter include Custom Incident Attribute names (ciaName) and values (ciaValue). For example, you might want NNMi to forward an incident based on a particular status change notification trap. To do so, you would specify a Payload Filter that includes the name of the Custom Incident Attribute that stores the status information as well as the status change value string of interest.

To configure Forwarding to Global Managers:

  1. Select the Forward to Global Managers tab.
  2. Provide the required information (see table)
  3. Click  Save and Close to save your changes and return to the previous form.
Forwarding Configuration Attributes
Name Description
Enable

Use this attribute to enable or temporarily disable an incident's Forward to Global Managers settings:

Disable  = Temporarily disable the selected configuration.

Enable  = Enable the selected configuration.

Payload Filter

The Payload Filter Editor enables you to create expressions that further refine the filters used to select the incidents that NNMi forwards to other servers. Make sure to design any complex Payload Filters offline as a Boolean expression first. This method can help to minimize errors when entering your expressions using the Payload Filter editor.

When creating a Payload Filter, note the following:

  • Payload Filter expressions for the like and not like operators use the syntax defined for java regular expressions (java.util.regex Pattern class).
  • You must use a ciaName that already exists in the trap or event you are configuring.
  • Each set of expressions associated with a Boolean Operator is treated as if it were enclosed in parentheses and evaluated together.
  • View the expression displayed under Filter String to see the logic of the expression as it is created.
  • The AND and OR Boolean Operators must contain at least two expressions as shown in the example below.

    The following example filters incidents on voltage state:

    AND
          ciaName = .1.3.6.1.4.1.9.9.13.1.2.1.7
          ciaValue = 5

    NNMi evaluates the expression above as follows:

    (ciaName = .1.3.6.1.4.1.9.9.13.1.2.1.7 AND ciaValue = 5)

    NNMi finds all incidents with a varbind value of .1.3.6.1.4.1.9.9.13.1.2.1.7 and CIA value of 5.

  • The placement of your cursor and the subsequent text that is selected is important when performing operations using the Payload Filter Editor. For example, you append to, replace, or change the indentation of the expression that is selected.
  • The placement of your cursor and the subsequent text that is selected is especially important when adding your Boolean operators.
Payload Filter Editor Settings
Attribute Description
Attribute

The attribute name on which NNMi searches. Filterable attributes include the following:

  • ciaName
  • ciaValue
Operator

Valid operators are described below.

Value

The value for which you want NNMi to search.

Note the following:

  • The values you enter are case sensitive.

  • NNMi displays a variable number of value fields depending on the Operator selected. For example, the between Operator causes two value fields to be displayed.
  • The between, in and not in operators require that each value be entered on a separate line.
Payload Filter Editor Buttons
Button Description
Append Appends the current expression (Attribute, Operator, and Value) to the selected expression already included in the filter string.
Insert Inserts the current expression (Attribute, Operator, and Value) in front of the cursor location within the Filter String.
Replace Replaces the selected expression with the expression displayed in the Attribute, Operator, and Value fields.
AND

Inserts the AND Boolean Operator in the selected cursor location.

Note View the expression displayed under Filter String to see the logic of the expression as it is created.

OR

Inserts the OR Boolean Operator in the current cursor location.

Note View the expression displayed under Filter String to see the logic of the expression as it is created.

NOT

Can be used in any part of the Filter String to specify that NNMi should exclude interfaces with values that pass the expression that immediately follows the NOT.

For example, when evaluating the following expression, NNMi includes interfaces with (interface description) ifDesc containing VLAN, and excludes any Interfaces that have VLAN10 for the (interface name) ifName value: 

(ifDesc like VLAN AND NOT (ifName=VLAN10))

Note View the expression displayed under Filter String to see the logic of the expression as it is created.

EXISTS

Used for filters that include Capabilities or Custom Attribute names and values in the Filer String.

Indicates that you want NNMi to consider interfaces that have Capabilities or Custom Attributes when evaluating the Filter String.

Tip When creating complex Filter Strings that include customAttrName and customAttrValue pairs as one component of an "or" statement, to prevent NNMi from excluding Nodes that have zero Custom Attributes, use EXISTS or NOT EXISTS criteria for the customAttrName and customAttrValue pair definitions.

Otherwise Nodes that do not have any Custom Attributes are automatically excluded even if they have values that pass other aspects of your filter.

For example, when evaluating the following Filter String, NNMi includes interfaces with (interface description) ifDesc containing VLAN, as well as any Interfaces Custom Attribute Role value is LAN Connection to Oracle Server

(ifDesc like VLAN OR EXISTS((customAttrName=Role AND customAttrValue=LAN Connection to Oracle Server)))

Note View the expression displayed under Filter String to see the logic of the expression as it is created.

NOT EXISTS

Used for filters that include Capabilities or Custom Attribute names and values in the Filer String. Indicates that you want NNMi to consider interfaces that do not have any Capabilities or Custom Attributes when evaluating the Filter String, but exclude the interfaces that match the expression that follows the NOT EXISTS.

Tip When creating complex Filter Strings that include customAttrName and customAttrValue pairs as one component of an "or" statement, to prevent NNMi from excluding Nodes that have zero Custom Attributes, use EXISTS or NOT EXISTS criteria for the customAttrName and customAttrValue pair definitions.

Otherwise Nodes that do not have any Custom Attributes are automatically excluded even if they have values that pass other aspects of your filter.

For example, when evaluating the following expression, NNMi includes interfaces with (interface description) ifDesc containing VLAN, and excludes any Interfaces that have the Custom Attribute Role and that Role value is LAN Connection to Oracle Server

(ifDesc like VLAN OR NOT EXISTS((customAttrName=Role AND customAttrValue=LAN Connection to Oracle Server)))

Note View the expression displayed under Filter String to see the logic of the expression as it is created.

Delete

Deletes the selected expression.

Note If the Boolean Operator is selected, the Payload Filter Editor deletes all expressions associated with the Boolean Operator.