Administer > Extend NNMi Capabilities > Managing MIBs > Configure MIB Expressions > MIB Expression Form (Line Graphs)

MIB Expression Form (Line Graph)

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

  • From the  Configuration workspace > MIBs folder > 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 Line Graphs, use the MIB Expressions view.

Note  

  • NNMi supports one MIB expression per Line Graph.
  • You can re-use any MIB Expression that you create for NNMi Line 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.

    See Configure MIB Expressions for more information about configuring Line Graph. See MIB Expressions Form (Custom Poller) for more information about using the Custom Poller Configuration form.

To create a MIB Expression using the MIB Expression form:

  1. From the workspace navigation panel, select the  Configuration workspace.
  2. Expand the MIBs folder.
  3. Select the MIB Expressions view.
  4. Do one of the following:

    • To create a MIB Expression, click the  New icon.
    • To edit a MIB Expression, double-click the row representing the configuration you want to edit.
  5. Provide the required basic settings (see the MIB Expression Basic Attributes table).

  6. Only for Multiple Instance MIB Expressions. Line Graphs that display multiple instances use the following syntax for the line label that appears in the Graph legend:

     <node_name> <Line_Label>.<instance_string>

    In this instance, <Line_Label> is the Line Label value specified when using the MIB Specification form.

    Use the Instance Display Configuration section of the MIB Expression form to specify the configuration for the <instance_string> values (see the Instance Display Configuration table).

    See Use the MIB Expression Editor (Line Graph) for more information about multiple instance MIB Expressions.

  7. Click   Save and Close.

  8. To test your MIB Expression, select ActionsGraph MIB Expression. See Test a MIB Expression (Line Graph) for more information.

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

    • You must save the MIB Expression before you use ActionsGraph MIB Expression.
    • 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>.

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 Variable 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 (Line Graph) for information about using the MIB Expression editor.

Note The MIB containing the variable must be loaded on the NNMi management server.

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 instance portion (<instance_string>) of the line label appears in the Line Graph legend.

Line labels in a Line Graph use the following syntax: 
<node_name> <Line_Label>.<instance_string>

In this instance, <Line_Label> is the Line Label value specified when using the MIB Specification form.

Possible Conversion Algorithms are:

  • Numeric - Use this option to display the instance number returned by the SNMP query as the <instance_string> value. This format is useful when no meaningful name is available in the MIB. For example, Line Graphs that display CPU information might use this format.
  • 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 as the <instance_string> value of the line label in the Line Graph legend.
  • 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' in the <instance_string> of the line label.
  • Interface Name - Use this option to display the interface name (ifName, if any) as the <instance_string> value in the Line Graph legend. 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 as the <instance_string> value in the line label of the Line Graph legend.

NNMi uses the Conversion Algorithm you specify to determine how to obtain the <instance_string> value.

Display Filter

When you display the Line Graph, the data displayed in the Line Graph is filtered based on the criteria you provide here.

Enter a valid regular expression that specifies the pattern you want NNMi to match when determining the values to display in the <instance_string> value of each line label.

Note 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