MIB Expressions Form (Custom Poller)

[This is the context-sensitive help for the MIB Expression Form]

You can access the MIB Expression form in the following ways:

  • From the  Configuration workspace > MIBsfolder > MIB Expressions view.
  • From the  Configuration workspace > Monitoring folder > Custom Poller Configuration form
  • From the MIB Specification form. (Used when configuring SNMP Graph actions.)

When you want to create a MIB Expression to be used in Graphs, use the MIB Expressions view. See MIB Expression Form (Line Graph) for more information.

When you want to create a MIB Expression to be used in a Custom Poll, use the Custom Poller Configuration form.

You can re-use any MIB Expression that you create for NNMi graphs or for Custom Poller. Use MIB Expressions View to see a list of the available MIB Expressions. Use the Loaded MIBs View to see a list of the MIBs loaded on the NNMi management server. 

To create a MIB Expression using the Custom Poller Configuration form:

  1. In the MIB Expression attribute, click the Lookup icon and do one of the following:

    • Select Quick Find to select and edit an existing MIB expression.
    • Select Open to edit the current MIB expression.
    • Select New to create a MIB expression.
  2. Provide the required basic settings (see the MIB Expression Basic Attributes table).

  3. Click   Save and Close to return to the Custom Poller Configuration form.

    You must save the MIB Expression before you use ActionsGraph MIB Expression.

  4. To test your MIB Expression, select ActionsGraph MIB Expression. See Test a MIB Expression (Custom Poller) for more information.

    You can right-click any object in a table or map view to access the Actions menu.

    The NNMi administrator determines the label that is used to identify the data instances that are displayed in Line Graphs using the Instance Display Configuration (see the Instance Display Configuration table). If the Instance Display Configuration is not set, NNMi identifies each instance that appears in a Line Graph using the Node's short DNS Name followed by the MIB Instance value in the format: <node_name> -<MIB_instance_value>. This value also appears as the Display Attribute in the Custom Polled Instance View.

MIB Expression Basic Attributes
Attribute Description
Unique Key

Used as a unique identifier when exporting and importing MIB Expression definitions. To ensure that the value you enter is unique, it is recommended that you use the Java name space convention when providing this value. It is also useful to include the label value as part of the unique key as shown in the following example:

com.<your_company_name>.nnm.mibexp.<mib_expression_name>

The maximum length is 80 characters.

Note Unlike the Unique Key attributes associated with other objects, you can change the MIB Expression configuration's Unique Key value at any time.

Name

The name you want to use for the MIB information being polled. This name can be the same name as a MIB OID used in the MIB Expression, or you can enter a name of your choice.

Type a maximum of 50 characters. Alpha-numeric and special characters (~ ! @  $ % ^  * ( ) _+) are permitted. No spaces are permitted.

Author

Indicates who created or last modified the MIB Expression.

If the Author attribute value is Network Node Manager, any changes are at risk of being overwritten in the future.

  • Click  Lookup and select  Show Analysis to display details about the currently selected Author.
  • Click  Quick Find to access the list of existing Author values.
  • Click  New to create an Author value.
Expression

Click the button to access the MIB Expression editor. See Use the MIB Expression Editor (Custom Poller) for information about using the MIB Expression editor.

Valid types for the MIB variables that can be included in a MIB expression for Custom Poller include the following:

  • Integer
  • Unsigned Integer
  • Gauge
  • Counter
  • Counter64
  • TimeTicks
  • Octet String

Note the following:

  • The MIB containing the variable must be loaded on the NNMi management server.
  • If a MIB Expression includes more than one MIB Variable that has multiple instances (Table Entry MIB), select a MIB Filter and MIB Filter Variable that can be consistently applied to each Table Entry MIB in the expression.
  • Although it is strongly discouraged, to configure Custom Polling for all instances of a repeating MIB, you can use the same MIB variable for both the MIB Expression and the MIB Filter Variable.
  • If your MIB Expression contains an invalid MIB Variable, NNMi is not able to create an associated Polled Instance. If Polled Instances are not created as expected, check the Custom Node Collection view for Discovery State and Discovery State Information values.
  • If Polled Instances are created, but errors occur while processing the MIB Expression data from a device's SNMP Agent, information is logged to the analysis.0.0.log file. Examples of possible errors include divide by zero (0) or data unavailable. See Verify that NNMi Services are Runningfor more information about log files.
  • When evaluating MIB expressions that include MIB variables of type Counter, Counter64 or Time_Ticks, NNMi evaluates the MIB Variable using the difference in value between the most recent poll and the poll before it. If you want NNMi to calculate a rate over time in seconds, divide the MIB Expression by sysUptime. For example:

    (((ifInOctets+ifOutOctets)*8/ifSpeed)*100)/sysUpTime*0.01

    Tip The sysUpTime variable is a value of hundredths of a second. When you want the rate in seconds, use sysUpTime*0.01 in the MIB expression as shown in the previous example.

  • If you use a MIB variable of type Counter, Counter64 or Time_Ticks in the MIB Expression, NNMi automatically collects sysUpTime values if sysUpTime is not already in the MIB Expression. NNMi uses the sysUptime value to detect a system reboot. Any time a system reboot is detected, NNMi cannot determine the difference in values between polls for any Counter MIB variable and therefore does not calculate the MIB Expression for that poll.
Display numeric MIB OIDs in the Expression

Enables you to display the MIB object identifier (OID) rather than the MIB variable name in the MIB Expression.

Select Display numeric MIB OIDs in the Expression  to replace any MIB variable name with the MIB OID value in the MIB Expression.

Clear Display numeric MIB OIDs in the Expression  to display the MIB variable names rather than the MIB OIDs within the MIB Expression.

Description

NNMi provides the Description attribute to help you further identify the current MIB Expression configuration.

Use the description field to provide additional information that you would like to store about the current MIB expression configuration.

Type a maximum of 2000 characters. Alpha-numeric and special characters (~ ! @ # $ % ^ & * ( ) _+ -) are permitted.

Instance Display Configuration
Attribute Description
Conversion Algorithm

Used to determine the format in which the value contained in the Display Variable appears in the NNMi console.

NNMi applies the Display Filter to each Display Variable to determine the value to display.

Possible Conversion Algorithms are:

  • Numeric - Use this option to display the instance number returned by the SNMP query. This format is useful when no meaningful name is available in the MIB. For example, you might use this format to display CPU information.
  • MIB Variable - Use this option to display the value that is stored in the MIB variable you specify. To obtain each MIB variable value, NNMi appends the instance number to the MIB variable specified. The result from the SNMP query is converted to a text string and displayed.
  • Alphabetic - Use this option to display information for legacy Cisco Arrow Point load balancers. When using this algorithm, each instance number returned by the SNMP query is treated as a set of ASCII characters instead of numbers. For example, the instance 101.120.97.109.112.108.101 would be displayed as 'example'.
  • Interface Name - Use this option to display the interface name (ifName, if any). If the SNMP agent responds to an ifName request with null, the ifIndex value is queried and used instead.
  • Interface Name Indirect - Use this option to display the Interface Name value obtained from an indirect reference in the MIB table. For example, if the MIB variable you specify resides in an RMON MIB table, use this algorithm. If the SNMP agent responds to an ifName request with null, the ifIndex value is queried and used instead.
Display Variable

Select the MIB variable you want to display.

When you define multiple MIB Variables for a Custom Poller Collection, you must specify the same Display Attribute for each MIB Variable in the Custom Poller Collection.

NNMi uses the Conversion Algorithm you specify to determine how to obtain the Display Variable's value.

Display Filter

The value that NNMi displays for the Display Variable is determined by the criteria you provide here. This value is indicated as Display Attribute in the NNMi console.

Enter a valid regular expression that specifies the pattern you want NNMi to match when determining the values to display.

NNMi uses the syntax defined for java regular expressions (java.util.regex Pattern class).

NNMi finds the first character sequence that matches the Display Filter expression. If NNMi does not find a match for the Display Filter, it returns the Display Variable name.

For example, if you have several interfaces with an ifDescr set to "FastEthernet" followed by a unique set of numbers for each interface (such as FastEthernet0/1, FastEthernet0/2, FastEthernet0/3, and so on), you can use the following Display Filter to display "Ethernet" followed by the unique set of numbers:

(Ethernet.*[0-9]+){1}

In the example, the following matches occur:

  • Ethernet matches Ethernet
  • The .* matches 0/
  • The [0-9]+ matches any sequence of numbers
  • The {1} specifies to match the expression exactly one time

In this example, possible Display Values include FastEthernet0/1, FastEthernet0/2, and FastEthernet0/3.