nimsoft monitor snmpget guidedocs.nimsoft.com/.../snmpget/1.8/snmpget-1.8.pdf · to use the snmpget...

snmpget Guide v1.8 series

Nimsoft® Monitor™

Legal Notices Copyright © 2013, CA. All rights reserved.

Warranty

The material contained in this document is provided "as is," and is subject to being changed, without notice, in future editions. Further, to the maximum extent permitted by applicable law, Nimsoft LLC disclaims all warranties, either express or implied, with regard to this manual and any information contained herein, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Nimsoft LLC shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein. Should Nimsoft LLC and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these terms, the warranty terms in the separate agreement shall control.

Technology Licenses

The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license.

No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Nimsoft LLC as governed by United States and international copyright laws.

Restricted Rights Legend

If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as "Commercial computer software" as defined in DFAR 252.227-7014 (June 1995), or as a "commercial item" as defined in FAR 2.101(a) or as "Restricted computer software" as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Nimsoft LLC’s standard commercial license terms, and non-DOD Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as defined in FAR 52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than Limited Rights as defined in FAR 52.227-14 (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any technical data.

Trademarks

Nimsoft is a trademark of CA.

Adobe®, Acrobat®, Acrobat Reader®, and Acrobat Exchange® are registered trademarks of Adobe Systems Incorporated.

Intel® and Pentium® are U.S. registered trademarks of Intel Corporation.

Java(TM) is a U.S. trademark of Sun Microsystems, Inc.

Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.

Netscape(TM) is a U.S. trademark of Netscape Communications Corporation.

Oracle® is a U.S. registered trademark of Oracle Corporation, Redwood City, California.

UNIX® is a registered trademark of the Open Group.

ITIL® is a Registered Trade Mark of the Office of Government Commerce in the United Kingdom and other countries.

All other trademarks, trade names, service marks and logos referenced herein belong to their respective companies.

For information on licensed and public domain software, see the Nimsoft Monitor Third-Party Licenses and Terms of Use document at: http://docs.nimsoft.com/prodhelp/en_US/Library/index.htm?toc.htm?1981724.html.

http://docs.nimsoft.com/prodhelp/en_US/Library/index.htm?toc.htm?1981724.html

Contact Nimsoft

For your convenience, Nimsoft provides a single site where you can access information about Nimsoft products.

At http://support.nimsoft.com/, you can access the following:

■ Online and telephone contact information for technical assistance and customer services

■ Information about user communities and forums

■ Product and documentation downloads

■ Nimsoft Support policies and guidelines

■ Other helpful resources appropriate for your product

Provide Feedback

If you have comments or questions about Nimsoft product documentation, you can send a message to [email protected].

http://support.nimsoft.com/

mailto:[email protected]

Contents 5

Contents

Chapter 1: snmpget 1.8 7

General Overview ......................................................................................................................................................... 7

Chapter 2: Probe Deployment 9

Supported Platforms .................................................................................................................................................... 9

System Requirements .................................................................................................................................................. 9

Software Requirements ............................................................................................................................................... 9

Probe Deployment Information ................................................................................................................................... 9

Chapter 3: snmpget Configuration 11

Probe Configuration Interface Installation ................................................................................................................. 13

Probe Defaults ............................................................................................................................................................ 13

Probe GUI ................................................................................................................................................................... 13

The Toolbar ......................................................................................................................................................... 14

The Left Pane ...................................................................................................................................................... 15

The Right Pane .................................................................................................................................................... 16

Probe Configuration ................................................................................................................................................... 18

SNMP Variables ................................................................................................................................................... 18

Setting General Properties .................................................................................................................................. 19

Configuring Agent profiles .................................................................................................................................. 20

Attaching SNMP Variables and Templates .......................................................................................................... 23

Configuring SNMP Variable Properties ............................................................................................................... 27

Monitoring SNMP Variables ................................................................................................................................ 34

Display the Current SNMP Variable Values ......................................................................................................... 36

MIB Management ............................................................................................................................................... 38

Bulk Configuration............................................................................................................................................... 42

Chapter 4: snmpget Metrics 45

Chapter 1: snmpget 1.8 7

Chapter 1: snmpget 1.8

This description applies to snmpget probe version 1.8.

This section contains the following topics:

General Overview (see page 7) Documentation Changes (see page 8)

General Overview

The Nimsoft Monitor SNMP Get probe performs SNMP GET queries to selected SNMP devices transforming the query result into alarms and/or quality of service (QoS) messages for SLA purposes. The user may configure the profile to his/her requirements in order to integrate the device seamlessly into the Nimsoft Monitor solution. Browse the remote SNMP agent for the information you require and create monitoring solutions by drag-and-drop operations.

General Overview

8 snmpget Guide

Documentation Changes

This table describes the version history for this document.

Version Date What's New?

1.8 February 2013 ■ Added probe defaults.

■ Added information for the Consider Elapsed Time check box and Reg Ex to fetch numeric value text box on the variable properties dialog box.

1.6 August 2011 Provided option for selecting different QoS source and Alarm source.

Related Documentation

Documentation for other versions of the snmpget probe (../../snmpget.html)

The Release Notes for the snmpget probe

Getting Started with CA Nimsoft® Probes

Monitor Metrics Reference Information for CA Nimsoft Probes

Chapter 2: Probe Deployment 9

Chapter 2: Probe Deployment


Supported Platforms (see page 9) System Requirements (see page 9) Software Requirements (see page 9) Probe Deployment Information (see page 9)

Supported Platforms

The snmpget probe supports the same set of operating systems and databases as supported by the Nimsoft Server solution. Please refer to the Nimsoft Compatibility Support Matrix for the latest information on supported platforms.

System Requirements

The snmpget probe should be installed on systems with the following minimum resources:

■ Memory: 2-4GB of RAM. Probe's OOB configuration requires 256MB of RAM'

■ CPU: 3GHz dual-core processor, 32-bit or 64-bit

Software Requirements

The snmpget probe requires the following software environment:

■ Nimsoft Monitor Server 5.1.1 or later

■ Nimsoft robot version 5.23 or later

■ Java Virtual Machine 1.6 or later (typically installed with NMS 5.0 and above)

Note: For SOC functionality, NM Server 5.6 or later and UMP 2.5.2 or later is required.

Probe Deployment Information

There are two ways to distribute archive packages. You can distribute the package within Infrastructure Manager or use the standalone Nimsoft Distribution application.

See Probe Deployment for more information on deploying probes.

http://support.nimsoft.com/downloads/doc/NMSCompatibility_SupportMatrix_current.pdf

http://support.nimsoft.com/downloads/doc/NMSCompatibility_SupportMatrix_current.pdf

http://docs.nimsoft.com/prodhelp/en_US/Probes/GettingStarted/1931642.html


Chapter 3: snmpget Configuration

Probe Deployment Information

12 snmpget Guide

The SNMPget probe is a Simple Network Management Protocol (SNMP) application that uses the SNMPget request to query for information on a network entity supporting SNMPv1, SNMPv2c or SNMPv3. You may configure profiles containing one or more Object Identifiers (OIDs), or template references that refer to a set of OIDs to be shared amongst profiles. Each variable name is given in the format specified in snmp_variables.

To use the snmpget probe you should be familiar with the basic concepts of SNMP. When using SNMPget profiles, each profile (or template) represents one or more data values (OIDs) obtained from a host that supports SNMP. The profile specification includes the specification of the host, SNMP community and object identifiers that must be obtained. The SNMP information is obtained according to the specified profile interval. As with all other Probes, you can define alarm-triggering rules for the SNMPget probe.

Each SNMPget profile can collect information as 'static' OIDs (only configured for this profile), or via template references. Since a lot of SNMP object identifiers represent cumulative values, SNMPget creates a delta based on the current value - the last value.

Note: Probes that support SNMP on Linux (interface_traffic, snmptd and SNMPget) use an SNMP library that may cause newer Linux systems to issue the following message in the console log:

Process ‘SNMPget’ is using obsolete setsockopt SO_BSDCOMPAT

This is an informational message from the network portion of the glibc library that a now unsupported flag is being sent to the setsockopt function. This flag is ignored by the library and can safely be ignored. The reason for this message is that the SNMP library needs to support older versions of glibc which required this flag for sockets to work correctly.

The probe includes a User Interface to configure the probe. A MIB (Management Information Base) browser and a MIB file manager (wizard) for adding/removal of the remote MIB files as well.

The SNMPget probe includes following objects at the time of installation:

■ A Management Information Base repository (MIB), located in the Program Files/Nimbus/MIPS folder. The MIB repository contains definitions of the SNMP variables available from Agents supporting this MIB.

■ A User Interface (UI) to configure the probe. The User Interface is opened by double-clicking the line representing the probe in the Infrastructure Manager.

Initially the UI contains a dummy agent profile and a set of templates, containing a set of SNMP variables.

The probe configuration consists of the following steps:

■ Set the General Properties for the probe.

■ Configure one or more Agent Profiles.

Probe Configuration Interface Installation


■ Attach SNMP variables to the profiles, either dynamically, using templates, or statically.

■ In addition, you may run the MIB Setup wizard to upload and install MIB files from Internet and to add/remove MIB files from your local MIB repository.


Probe Configuration Interface Installation (see page 13) Probe Defaults (see page 13) Probe GUI (see page 13) Probe Configuration (see page 18)

Probe Configuration Interface Installation

The probe configuration interface is automatically downloaded and installed by the Nimsoft Infrastructure Manager when the probe is deployed on a robot.

Probe Defaults

At the time of deploying a probe for the first time on robot, some default configuration will be deployed. For this you have to drag and drop the system template to the profile. These probe defaults could be Alarms, QoS, Profiles and so on which save time to configure the default settings. These probe defaults will be seen on a fresh install, that is no instance of that probe is already available on that robot in activated or deactivated state.

Probe GUI

The window consists of two panes:

■ The Left Pane

■ The Right Pane

Probe GUI

14 snmpget Guide

The Toolbar

The configuration tool contains a toolbar, which allows you to configure the probe:

The toolbar contains following buttons:

General Setup

Opens the Setup dialog box for the probe, enabling you to modify the parameters and options.

Launch the MIB Browser

Launches the MIB browser, letting you find the SNMP variables available for an agent. See the Attach SNMP Variables and Templates section for more information.

Launch the MIB Setup Wizard

Launches the MIB setup wizard, helping you to upload and install MIB files from Internet and to add/remove MIB files from your local MIB repository.

Create New Agent Profile

Allows you to create a new host profile.

Create New Agent Group

Allows you to create a new agent group.

Create New OID Group

Lets you add folders under the selected host to group SNMP variables in a logical manner.

Create New Template

Allows you to add a new template.

Get the Current SNMP Variable Values

Updates the SNMP Variables listed in the right pane with the current values.

Bulk Configure

Displays the Bulk Configuration dialog box, which enables you to distribute a set of monitoring parameters to selected hosts (see Bulk Configuration).

Note: The MIB is included in the probe distribution and is stored in the Program Files/Nimbus/MIBS folder. The contents of the MIB repository can be modified (adding or deleting files) by running the MIB Wizard.

Probe GUI


The Left Pane

The left pane displays:

■ The hosts to be monitored optionally grouped into folders.

■ The QoS definitions available. You can also add new ones. If you want to publish QoS data for a SNMP variable, you may select between the ones defined here.

■ The different templates contain a number of variables. These templates can be attached to an agent, and the templates are typically used to simplify profile management of many similar devices. You may extend/modify the monitoring of many agents referring to the same template simply by adding/modifying a variable in the template

Right-clicking in the left pane provides following options:

New

Opens the properties dialog, letting you define a new group, host, QoS definition or template, depending on what type of element you have selected in the pane when right-clicking.

Edit

Lets you edit the properties for the selected host.

Rename

Lets you rename the selected host or group.

Delete

Lets you delete the selected group, host, QoS definition or template.

Browse

Use this option to launch the MIB browser to help you find available SNMP variables for the selected agent profile.

The symbols in the left pane indicate if a monitored host responds or not:

Indicates that the host responds.

Indicates that the host does not respond.

Indicates either that the profile is just created, but you have not yet clicked the Apply button, or the profile is not active.

Probe GUI

16 snmpget Guide

The Right Pane

The right pane is multi-functional and displays:

■ Hosts and groups when the Group node is selected in the left-pane.

■ Hosts if a group is selected in the left pane.

■ SNMP variables for the selected host when a host is selected in the left-pane.

■ QoS definitions available when the QoS node or a QoS definition is selected in the left pane.

■ Templates available when the Template node is selected.

■ SNMP variables defined for the template if a template is selected in the left pane.

Right-clicking in the right pane provides following options:

New

Opens the properties dialog, letting you define a new group, host, QoS definition or template, depending on what type of element you have selected in the pane when right-clicking.

Edit

Lets you edit the properties for the selected host or SNMP variable.

Delete

Lets you delete the selected host, template, SNMP variable or QoS definition.

Activate

Activates (starts monitoring) the selected host.

Deactivate

Deactivates (stops monitoring) the selected host.

Monitor

Opens the monitor window and starts monitoring the selected SNMP variable, where you can watch the graphs being filled.

Delta Value

Delta value displayed in the right pane is the difference between the current and the previous measured value.

Average Value

Average value of a variable is the normalized value for a performance object. You can trigger the average calculation process. If the average calculation process is triggered, it is calculated based on the number of samples defined for the variable.

SNMP variables indicators

The icons in front of the variable names have the following meaning:

Probe GUI


Green means OK.

Black means the "Enable monitoring" option and the "QoS" option is turned off in the properties dialog for the variable.

Other colors indicate the severity level selected (in the properties dialog for the variable) when the average value breaches the alarm threshold. The severity of the variable is calculated using the average value compared with its threshold. If the variable does not have any average value, then the severity is calculated using the current value of a variable.

Indicates that the OID is missing

Indicates that the "Enable monitoring" option is turned off, but the QoS option is selected in the properties dialog for the variable.

Probe Configuration

18 snmpget Guide

Probe Configuration

SNMP Variables

Variable names are in the format of OIDs (Object Identifiers (ASN.1)). There are several methods of representation. Each variable name is given in the format of A.B.C.D..., where A, B, C, and D are sub-identifiers in one of two forms of notation. Each sub-identifier may be encoded as a decimal integer, or a symbol as found in the RFC1066 Management Information Base (MIB). The case of the symbols is not significant.

If there is no leading "." in the variable name, the name is formed as if having been preceded with iso.org.dod.internet.mgmt.mib.

A "." must be placed before the first variable if the user is to fully specify the name.

For example:

1.1.0

system.sysDescr.0

1.sysDescr.0

.1.3.6.1.2.1.1.1.0

.iso.org.dod.internet.mgmt.mib.system.sysdescr.0

.1.3.6.1.2.1.1.sysdescr.0

all refer to the same variable name.

The description of the variables in the MIB is given in the set of MIB files located in the NimBUS/MIBS directory on the robot that is hosting the SNMPget probe.

Probe Configuration


Setting General Properties

Click the General Setup button on the toolbar to display the Setup dialog box for the probe.

The fields in the above dialog box are explained below:

Encrypt community string

When checked, passwords specified for the different agent profiles, are encrypted in the probe configuration file.

Display time ticks as numeric data type

If checked, time ticks (see the value field for a SNMP variable with time ticks) are displayed in number of seconds.

If NOT checked, the time ticks are displayed on the format dd: hh:mm: ss.ms (E.G. 10:7:20:20.47).

Default alarm message string

This is the default alarm message issued when alarm situations occur.

Note: You can use variables, such as oidgroup, agentgroup, and value, in an alarm message.

Log-level

Sets the level of details written to the log-file. Log as little as possible during normal operation to minimize disk consumption, and increase the amount of detail when debugging.

Items in sample array

This field defines the default value of number of samples for a probe.

Probe Configuration

20 snmpget Guide

Configuring Agent profiles

Clicking the Create New Agent Profile button on the toolbar displays the Profile dialog box.

Note: If you want to create an agent group for the new agent, right-click in the left pane and select New, or you can click the Create New Agent Group button on the toolbar.

Probe Configuration


Fields in the above dialog box are explained below:

Agent hostname or IP address

The host name or IP address to the agent.

Active

Activates the profile to monitor the selected SNMP Host.

Check interval

Allows you to specify the time interval.

Severity

Allows you select the severity for messages sent if the agent host does not respond.

Group

Allows you to select in which agent group to place the agent.

Message string for agent no response

Enter the message string for the notification when the host can not contact the agent. If you do not specify any message, the default message is displayed.

SNMP Properties

Version

SNMP software version number supported by the monitored device.

Authentication (SNMPv3 only)

Type of authentication strategy (none, HMAC-MD5-96 or HMAC-SHA-96). This field is available only when the SNMP version is SNMPv3

Port

The port to be used by the SNMP device. Default is 161.

Timeout

The timeout value in seconds before a new SNMP Get request is sent to the SNMP agent. The default value is 1 second.

Retries

Select the number attempts to be done before giving up and reporting it as a failure. An alarm is issued. Default value is 5 retries.

Community /password

Represents community, if SNMP version is selected as SNMPv1 or SNMPv2. Represents password, if SNMP version is selected as SNMPv3.

Note: Password string must be at least 8 characters long.

Username

Here you can specify a username defined on the monitored device. This field is available only when the SNMP version is SNMPv3.

Probe Configuration

22 snmpget Guide

Delay

The delay between each SNMP Get Request when fetching multiple OIDs from the SNMP Agent. The default value is none.

Show password

When checked, the entry in the password field is shown as plain text.

Security

Define the security level for the user. Valid levels are NoAuthNoPriv, AuthNoPriv, and AuthPriv. This field is available only when the SNMP version is SNMPv3.

Priv. Protocol

It is the privacy protocol for the SNMP. It is not required if the security level is NoAuthNoPriv or AuthNoPriv. This field is available only when the SNMP version is SNMPv3.

Priv. PassPhrase

It is the privacy passphrase. It is not required if the security level is NoAuthNoPriv or AuthNoPriv. It must be at least eight characters long. This field is available only when the SNMP version is SNMPv3.

QoS Identification Method

Select one of the QoS identification methods in order to specify the QoS source.

Alarm Suppression Key

Specifies the suppression key used to suppress alarms as per requirement. The format to specify a suppression key is snmpget|<string>/<variable>.

Note: If the Alarm Suppression Key field is left blank, then default suppression key is applied.

QoS Source

Allows you to select robot address, profile name, or host address as QoS source.

Alarm Source

Allows you to select host address or profile name as Alarm source.

Description

Specifies profile description.

Test

Click the Test button to check whether the SNMP host is responding or not.

Probe Configuration


Adding a new agent using ‘drag and drop’

Add New Agent Using Drag and Drop

You may also add an agent by opening a /etc/hosts file in WordPad and dragging the selection (IP-address and hostname) into the navigation pane and dropping it onto a group folder.

Attaching SNMP Variables and Templates

In this probe, you can attach SNMP variables and templates.

Follow these steps:

1. To find available SNMP variables for the selected agent profile, right-click the profile and select Browse.

Probe Configuration

24 snmpget Guide

The MIB Browser window appears, allowing you to browse for variables.

2. Select SNMP version and Object Identifier from the drop-down lists and click the Go! Button.

Note: You can select from the drop-down list and write directly into the Object Identifier (root) field.

3. Click button to add the written object identifier in the list.

4. Similarly, click to remove the selected object identifier.

All variables found are listed in the Query Response field at the bottom of the dialog.

Probe Configuration


Now you can attach the variables you want to the agent profile, using drag and drop. You mark the ones you want and drop them onto the probe’s variables window.

Group Variables in Folders

You can group variables in folders under the Agent Profiles. You create groups by selecting the Agent and clicking the folder icon in the Toolbar. When the new group appears under the Agent, you just give it a name. You can then start attaching variables to the group, using drag and drop, from the browser window.

Probe Configuration

26 snmpget Guide

Attach Templates

Another method is to attach the variables found in one of the template, to an agent profile or an agent group. Templates are typically used to simplify profile management of many similar devices. You may extend/modify the monitoring of many agents referring to the same template simply by adding/modifying a variable in the template.

You click the Template node, and all templates are listed in the right windowpane.

You can attach one of them to an agent profile or an agent group by selecting the template, dragging and dropping it onto the selected node.

If you just want to attach some of the variables under the template, you click on the template. The available variables are listed, and you drag and drop the ones you want onto the agent profile / group.

Make New Templates

You can easily compose your own templates by:

■ Selecting variables from other templates, dragging and dropping them onto the new template.

Or

■ Selecting variables from the Browse window, dragging and dropping them onto the new template.

Probe Configuration


Overwrite Template Variable

You can overwrite a template variable with a static variable on an agent configuration.

Configuring SNMP Variable Properties

Double-clicking one of the variables opens the variable properties dialog box. This dialog box can be expanded/collapsed by clicking the arrow to the right of the Description field. This opens/closes a frame containing the variables’ OID description fetched from MIB. You may copy/paste text from this frame and paste into the Description field and the Message string field in the variable dialog box, and in the Description field in QoS definition dialog box.

Now you can set the alarm and QoS definitions for the variable.

Probe Configuration

28 snmpget Guide

The fields in the above dialog box are explained below:

Name

The name of the variable.

Object Identifier (OID)

The Variable name in the format of an Object Identifier (see SNMP Variables).

Description

Here you can enter a description of the variable. Clicking the arrow to the right of the field opens a frame with an OID description fetched from MIB. You may copy/paste text from this frame and paste into the Description field.

The Value Frame

Definition

Defining which value to compare to the threshold value.

Automatic (based on type)

The value is automatically set based on variable type (integer, counter etc.).

When Automatic is chosen, the probe – based on data type— either fetches the current value or makes a delta calculation.

For the following data types a delta calculation is performed: counter32 and counter64.

For all other data types, the current value is fetched.

The current value

Uses the current (last measured) value

The delta value (current – previous):

Uses the delta value, which is the difference between the current and the previous measured value.

Note: The main window displays a 3-second delta computation.

Samples

Sampling defines normalized value for a performance object to be monitored.

By default, the sampling process is not enabled. The samples box is also not available. To perform the sampling process, select the Calculate average based on check box. The samples box becomes available, which displays default samples set in the General Setup Properties dialog. For example, in the following image, it is six.

You can change the number of samples. Enter a value other than zero or one in the samples box, to override the default sample value for any variable. This value has higher precedence than the default value of the number of samples, set in the General Setup Properties dialog for a probe.

Probe Configuration


If you enter number of samples equal to one, then sampling process is not performed. As a result, average value of the variable samples is not calculated.

Similarly, if you enter number of samples equal to zero, then sampling is not calculated. Next time when you open the Variable dialog, it displays the default number of samples.

You cannot keep the samples box blank. The OK button becomes unavailable if you keep the number of samples blank.

Calculate value using ratio

Select this check box to multiply the variable value with a number (ratio):

E.g. a ratio of 0, 1 (value * 0, 1) means 10 % of the value. Enter the ratio value in the box.

Force the variable value as a numeric value type

Select this option to force the probe to treat a data type as a numeric value. For example, the string:"2.5" will be treated as the numeric value 2.5 if this option is ticked.

Note: Comparison of Delta value against Threshold value is not applicable for the variables of data types ASN_OCTET_STR & ASN_IPADDRESS even if Force the variable as numeric value type is selected.

Reg Ex to fetch numeric value

Specifies the regular expression used to fetch numeric value from string, this numeric value is then compared with the threshold value. For example, If value of an OID is: Capabilities for NAT-MIB LAST-UPDATED 200109100000Z ciscoIetfNatCapabilityV12R02T AGENT-CAPABILITIES SUPPORTS CISCO-IETF-NAT-MIB Filename:ios and the value to be fetched is 02.

Then the regular expression to fetch the value 02 will be:

[^\d]*[\d]+[^\d]*[\d]+[^\d]+([\d]+)

Now, the fetched value 02 is compared with the threshold value.

Note: The Reg Ex to fetch numeric value text box is available only if the Force the variable value as a numeric value type check box is selected.

Consider Elapsed Time

Select this check box to consider elapsed time while calculating the counter type OIDs.

Note: If the Consider Elapsed Time check box is selected, then Counter type OIDs are calculated as: (Current Value – Previous Value)/Elapsed Time in seconds

Also, the Consider Elapsed Time option is currently applicable to counter types only.

Enable Monitoring

Enables monitoring of the variable.

Probe Configuration

30 snmpget Guide

Rule / Extend Rule tabs

These tabs are activated when the option Enable Monitoring is selected (see above).

The fields on these tabs define the alarm and QoS conditions for the variable.

You have the option to use one or two levels of alarm triggering rules:

You define a set of alarm triggering rules on the Rule tab and alternatively also a set of additional alarm triggering rules on the Extended Rule tab.

See the EXAMPLE later in this table.

IMPORTANT: Rule has to trigger before the extended rule is checked.

Note: The Extended Rule tab is disabled if selecting the operator = in the Rule tab.

Operator

Allows you to select equal to (=) or not equal to (!=) operator when defining a threshold value for alarms to be generated.

Threshold value

Specifies the regular expression used to define threshold value. An alarm is generated if this threshold is breached. For example, if the regular expression /dd*/ is specified as threshold value, then an alarm is generated if a string value is suffixed by dd.

Alarm severity level

The severity level of the alarms issued when the specified threshold value is breached. You may choose between five severity levels (from Information to Critical).

Message string

Here you can type a text string describing the alarm situation. If nothing is specified here, the default message (defined under General Properties for the probe) is used.

Note: You can copy the text from the OID Description frame and paste into this field. You can also use variables, such as oidgroup, agentgroup, and value, in an alarm message.

Publish Quality of Service (QoS)

If this option is checked, QoS data is sent at the specified check interval for the profile.

QoS Name

Here you may define a new QoS, you may select the default QoS or another available Default QoS for the variable.

For example,

Rule:

Probe Configuration


Operator =>, Value 5, Severity Major

Extended Rule:

Operator =>, Value 10, Severity Critical

This means: If the measured value is 6, the alarm message specified on the Rule tab (severity level Major) is issued.

If the measured value is 13, the alarm message specified on the Extended Rule tab (severity level Critical) is issued.

Advanced Tab

Subsystem ID

Allows you to define a subsystem ID on the Nas), which is included in the alarm message.

Message string on Clear

Allows you to define your own message to be issued when an alarm is cleared. This message overrules the default message.

The Missing OID Tab

The Missing OID tab manages alarm settings for the missing OIDs.

The fields in the above dialog box are as follows:

Alarm on missing OIDs

Select this check box to raise an alarm when any OID is missing.

Severity Level

Define the alarm severity level by selecting an option from the drop down menu.

Message for Missing OID ( Error Message)

Enter the alarm message string to be displayed when an OID is missing.

Message for Missing OID ( Clear Message)

Enter the alarm message string to clear the Missing Alarm message.

Probe Configuration

32 snmpget Guide

Publish Quality of Service

You can select to publish Quality of Service data by checking the Publish QoS option in the properties dialog for a variable.

From the drop-down list at the bottom of the dialog, you may select between:

■ The default QoS for the variable

■ Define and a new QoS

■ Select one of the defined QoS definitions, if any.

Apply the settings by clicking the OK button to exit the dialog and then click the Apply button on the Probe User Interface.

Subsequently, the QoS appears in the Service Level Manager under the Quality of Service / SNMP variable / SNMP Variable node.

Add New Quality of Service

In this probe, you can add e new quality of service.

Follow these steps:

1. Open the properties dialog box for a variable and select the Publish Quality of Service check box.

2. Select Add a new QoS Definition from the QoS Name drop-down list.

Probe Configuration


The QoS Properties dialog for the variable appears.

3. Define your QoS. Note that you may copy/paste text from the OID Description frame (see variable dialog description above) and paste into the QoS Description field. Click the OK button to save and exit.

Subsequently, the new QoS definition appears in the QoS drop-down list at the bottom of the Variable dialog and under the QoS node in the Navigation Pane. The group specified in the dialog appears under the Quality of Service node in the Service Level Manager, containing the new variable.

Delete QoS Definition

When you delete a QoS definition in the SNMPget user-interface, references to the QoS object are removed from the templates and/or profiles that use this object. However, it removes neither the QoS data nor the QoS object in the SLM database. Use the Service Level Manager to perform the necessary QoS management.

Change QoS Definition

Use the Service Level Manager to perform the necessary QoS management.

Dynamic Index Tracking

Select the Dynamic Index Tracking check box if the OID that you want to monitor changes index.

Probe Configuration

34 snmpget Guide

You should look for a value in a specified SNMP MIB Table and use the index of the entry that matches a specific value.

If you have the required MIBs loaded, you may specify the "MIB Table" using the symbolic (textual) form. Alternatively, you can use the numerical form (e.g., .1.3.6.1.2.1.2.2.1.2 that translates to IF-MIB::ifDescr).

The following are valid symbolic forms for the OID .1.3.6.1.2.1.2.2.1.2:

■ IF-MIB::ifDescr

■ ifTable.ifEntry.ifDescr

■ ifDescr

The probe will do a snmpwalk of the specified table, and search for the specified value. The comparison of values is case insensitive. The index found for the value match will be used as the index for the specified OID when doing the snmpget operation.

The Index will be updated on each poll interval. First, the last known Index is tried. If there is no match anymore (i.e. value has changed), the probe does a snmpwalk of the specified SNMP MIB table and updates the Index with a new one (if the specified value can be found at another index).

You can click the Test button to check the current Index and to confirm whether you have specified a valid MIB Table and/or value to search.

The probe GUI has no restrictions on entering invalid values. But if you enter an invalid value in the Value field, then a question mark is appended to the Object Identifier.

Note: Use the Missing OID Alarm in order to receive alarms which indicate that the OID cannot be found (i.e. OID is missing).

Monitoring SNMP Variables

You may monitor the sample values from any SNMP variable by right-clicking the variable and selecting Monitor.

Probe Configuration


A small monitor window pops up, showing the sample values as a graph in green color. It also shows graph of average sample values in blue color.

The green line in the graph denotes the current value of the variable, whereas the blue line in the graph denotes the average value of last N samples. The orange colored horizontal line shows the threshold value of the variable.

The lower part of the monitor window contains the following four fields:

■ Interval

Left-clicking in this field makes a drop-down menu available, enabling you to select the sample rate for the monitor window. This interval overrides the check-interval defined for the profile.

■ Sample

Samples denote the total number of samples collected till the current point of time. For example, in the preceding image, twelve samples are collected.

■ Average value of last 6 samples:

This field denotes average value of the current last N samples, where N denotes the number of samples defined for a variable. For example, in the preceding image, average of last six samples is displayed.

■ Value

This field denotes the current value of the variable, received from the probe. The color indicates the current severity level of the variable, based on the severity levels defined for a variable.

Probe Configuration

36 snmpget Guide

Left-clicking one of the corners of the monitor window enables you to resize the window. Placing the cursor inside the window and clicking <ctrl>+ s saves the modified size. This is confirmed by the following message.

The window appears with the saved properties the next time it is opened.

On left-clicking in the graph, a vertical red line occurs. Moving this line inside the graph enables you to read the current value ( green graph) as well as average value of the last N samples ( blue graph), at the specific point of time. The current value and average value of last N samples are defined in the green and blue colors respectively at the bottom left corner in the graph.

Display the Current SNMP Variable Values

You can check the current values for the SNMP variables by activating the Values button in the Toolbar. When left-clicking a profile, the current values are be displayed in the Values column.

Probe Configuration


The different icons in the Name column in the right windowpane:

■ Monitor – The colour tells the severity level.

■ Report – Read only.

■ Counting – Some SNMP variables, such as counter32, requires two snapshots to measure the value. This icon is shown until the second snapshot (after approximately 5 seconds) is finished, and then the value is displayed in the Value column.

■ N/A – Not found on the selected agent.

Probe Configuration

38 snmpget Guide

MIB Management

Management information bases (MIBs) are a collection of definitions, which define the properties of the managed object within the device to be managed. Every managed device keeps a database of values for each of the definitions written in the MIB. A MIB is a kind of as an information warehouse.

The MIB is included in the probe distribution and is stored in the Program Files/Nimbus/MIBS folder.

Running the MIB Setup Wizard helps you to upload and install MIB files from Internet and to add/remove MIB files from your local MIB repository.

Note: MIB files uploaded from the Internet may contain errors and/or references to other MIB files, making them impossible to load at probe start-up.

To start the MIB Setup Wizard:

1. Click the Launch the MIB Setup Wizard button on the toolbar.

The Welcome dialog box appears.

Probe Configuration


2. Click one of the Internet links to download and store MIB files locally on your computer.

3. Click Next.

Step 1 of the wizard appears.

Note: You may also select multiple MIB files from a folder (using Windows explorer) and drag/drop them onto the list in the wizard. Press the + button to add the MIB files you just downloaded (if any) to your MIB repository or Press the - button to remove MIB files from your MIB repository.

4. Click Next when finished to display the Finish dialog box.

5. Click Finish to activate your modifications.

Probe Configuration

40 snmpget Guide

Start MIB Setup Wizard

In this probe, you can start the MIB Setup Wizard.

Follow these steps:

1. Click the Launch the MIB Setup Wizard button on the toolbar.

The Welcome dialog box appears.

Probe Configuration


2. Click one of the Internet links to download and store MIB files locally on your computer.

3. Click Next. Step 1 of the wizard appears.

Note: You may also select multiple MIB files from a folder (using Windows explorer) and drag/drop them onto the list in the wizard. Press the + button to add the MIB files you just downloaded (if any) to your MIB repository or Press the - button to remove MIB files from your MIB repository.

4. Click Next when finished to display the Finish dialog box.

5. Click Finish to activate your modifications.

Probe Configuration

42 snmpget Guide

Bulk Configuration

Click the Bulk Configure button on the toolbar to open the Bulk Configuration dialog box, which enables you to distribute a set of monitoring parameters to all or a selection of interfaces on all agents or a selection of agents.

Probe Configuration


The fields in the above dialog box are as follows:

Select Agents

All agents

The configuration parameters are distributed to your monitored agents.

Only active ones

The configuration parameters are distributed to all active agents.

All agents matching

The configuration parameters are distributed to all agents matching your input in this field (pattern matching).

All agents in the group

The configuration parameters are distributed to all agents in the selected group.

Selected agent(s)

The configuration parameters are distributed to all agents selected in the right pane.

Check interval

Here you can specify the time interval (in seconds) between each time the SNMP agent is checked.

Severity

Here you can select the severity for messages sent if the agent host does not respond.

SNMP version

SNMP software version number supported by the monitored device.

Authentication (SNMPv3 only)

Type of authentication strategy (none, HMAC-MD5-96 or HMAC-SHA-96).

SNMP Port

The port to be used by the SNMP device. Default is 161.

Timeout

SNMP Get request is sent to the SNMP agent. The default value is 1 second.

Retries

Select the number attempts to be done before giving up and reporting it as a failure. An alarm is issued. Default is 5 retries.

Community Password

Represents community, if SNMP version is selected as SNMPv1 or SNMPv2. Represents password, if SNMP version is selected as SNMPv3.

Probe Configuration

44 snmpget Guide

Note: Password string must be at least 8 characters long.

Username (SNMPv3 only)

Specify a username defined on the monitored device.

Delay

The delay between each SNMP Get Request when fetching multiple OIDs from the SNMP Agent. The default value is none.

Show password

When checked, the entry in the password field is shown as plain text.

Security

Define the security level for the user. Valid levels are NoAuthNoPriv, AuthNoPriv, and AuthPriv. This field is available only when the SNMP version is SNMPv3.

Priv. Protocol

It is the privacy protocol for the SNMP. It is not required if the security level is NoAuthNoPriv or AuthNoPriv. This field is available only when the SNMP version is SNMPv3.

Priv PassPhrase

It is the privacy pass phrase. It is not required if the security level is NoAuthNoPriv or AuthNoPriv. It must be at least eight characters long. This field is available only when the SNMP version is SNMPv3.

QoS Identification Method

Select one of the QoS identification methods in order to specify the QoS source.

QoS Source

Allows you to select robot address, profile name, or host address as QoS source.

Alarm Source

Allows you to select host address or profile name as Alarm source.

Message string for agent no response

Enter the message string for the notification when the host cannot contact the agent. If you do not specify any message, the default message is displayed.

Chapter 4: snmpget Metrics 45

Chapter 4: snmpget Metrics

The following table describes the checkpoint metrics that can be configured using the snmpget probe.

Monitor Name Units Description

QOS_IFINOCTETS_65539 Bits/second interfaces.ifTable.ifEntry.ifInOctets.65539

QOS_SNMP_VARIABLE Value SNMP Variable

QOS_SNMP_VARIABLE_IFINOCTETS_65539 Bits/second interfaces.ifTable.ifEntry.ifInOctets.65539

QOS_SNMP_VARIABLE_MR_BUFFER_FAILURES Value The number of buffer failures

QOS_SNMP_VARIABLE_QOS_BES_AVGLATENCYINSECLAST10MSG_1_11

Value enterprises.rim.blackBerryServer.

besUserHealthTable.besUserHealthEntry.

besUserHealthAvgLatencyInSecLast10Msg.1.11M

QOS_SNMP_VARIABLE_QOS_BES_REQUESTSTOHANDHELD_1

Value enterprises.rim.blackBerryServer.besSysHealthTabesSysHealthEntry.

besSysHealthWERRequestsToHandheld.1

QOS_SNMP_VARIABLE_QOS_BES_SRPCONNECTEDSTATE_1

Value enterprises.rim.blackBerryServer.blackBerryDispa

dispHealthVariables.dispSysHealthSRPConnectedS

QOS_SNMP_VARIABLE_QOS_BES_SYSHEALTH_MSGERRORS_1

Value enterprises.rimblackBerryServer.besSysHealthTab

besSysHealthEntry.besSysHealthMsgErrors.1

QOS_SNMP_VARIABLE_QOS_BES_WERREQUESTSFROMHANDHELD_1

Value enterprises.rim.blackBerryServer.besSysHealthTa

besSysHealthEntry.besSysHealthWERRequestsFro

QOS_SNMP_VARIABLE_QOS_BESSYSHEALTHMSGERRORS_1

Value enterprises.rim.blackBerryServer.besSysHealthTab

besSysHealthEntry.besSysHealthMsgErrors.1

QOS_SNMP_VARIABLE_SYSUPTIME Centiseconds system.sysUpTime.sysUpTimeInstance

QOS_SNMP_VARIABLE_UPSBATTERYCAPACITYREMAINING

Percent upsBatteryCapacityRemaining

QOS_SNMP_VARIABLE_UPSBATTERYREPLACEINDICATOR

value upsBatteryReplaceIndicator

Probe Configuration

46 snmpget Guide

Monitor Name Units Description

QOS_SNMP_VARIABLE_UPSBATTERYRUNTIMEREMAINING

hours upsBatteryRunTimeRemaining

QOS_SNMP_VARIABLE_UPSBATTERYSTATUS State upsBatteryStatus

QOS_SNMP_VARIABLE_UPSBATTERYTEMPERATURECELSIUS

Celsius upsBatteryTemperatureCelsius

QOS_SNMP_VARIABLE_UPSELAPSEDTIMEONBATTERY

hours upsElapsedTimeOnBattery

QOS_SNMP_VARIABLE_WGW_SYSTEMUP_TIME Value System Uptime

nimsoft monitor snmpget guidedocs.nimsoft.com/.../snmpget/1.8/snmpget-1.8.pdf · to use the snmpget...

Documents