SNMP

To Probe Index

SNMP > Basic OID

SNMP - Basic OID

This probe lets you monitor a single, user-defined MIB variable.

Object Name is the name of the value that you want to monitor. This parameter is optional; the "object name" value only customizes the display in the popup window and chart legend.

Object ID is the object identifier (OID) of the value that you want to monitor. If you wish to retrieve the value of a MIB variable that is not in a table, the OID must end with ".0" (e.g. "1.3.6.1.2.1.1.1.0").

This probe retrieves a lot of SNMP information from the device, including the MIB-II system group and the interfaces table. If you only want to monitor a single SNMP variable, you can use the SNMP/Single OID probe.

Filename: com.dartware.snmp.basic
Version: 0.7

Back to Top

SNMP > Comparison

Comparison Probe

This probe retrieves a single SNMP MIB variable, compares it to a specified value, and sets the device's severity based on the comparison. It also displays the value in the Status Window.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Test set the dropdown to indicate whether to alarm if the device is equal/not equal to the Value parameter.

Value is the value to compare against.

Severity for the device if the comparison isn't as expected.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is an optional text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidcomparison.txt
Version: 1.10

Back to Top

SNMP > High Threshold

SNMP Value Too High

This probe retrieves a single SNMP MIB variable and compares it to the thresholds below. If the value goes above any of these thresholds, the device severity will go into the indicated state.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Critical, Alarm, and Warning are the thresholds for those severities. They may be positive or negative numbers.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is a text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidhigh.txt
Version: 1.5

Back to Top

SNMP > Low Threshold

SNMP Value Too Low

This probe retrieves a single SNMP MIB variable and compares it to the thresholds below. If the value goes below any of these thresholds, the device severity will go into the indicated state.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Critical, Alarm, and Warning are the thresholds for those severities. They may be positive or negative numbers.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is a text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidlow.txt
Version: 1.5

Back to Top

SNMP > Range Threshold

SNMP Value In Range Probe

This probe retrieves a single SNMP MIB variable and compares it to the thresholds below. If the value goes outside the designated bands, the device severity will go into the indicated state.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Critical, Alarm, and Warning are the thresholds for those severities. They may be positive or negative numbers.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is a text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidrange.txt
Version: 1.6

Back to Top

SNMP > Restricted Interface

SNMP - Restricted Interface

This probe is identical to the Basic SNMP Traffic probe except it restricts the visible interfaces to those that match the specified interface description.

Interface Description specifies which interfaces to display. Interfaces with a value of ifDescr that match this pattern will be visible on the map. Interfaces with non-matching ifDescr will automatically be hidden.

Filename: com.dartware.snmp.restrictedint.txt
Version: 0.1

Back to Top

SNMP > Single OID Viewer

Single OID Viewer

This probe retrieves a single SNMP MIB variable and displays it in the device's Status Window.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is a text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidsingle.txt
Version: 1.4

Back to Top

SNMP > SNMP High PPS

High PPS Probe

This probe monitors the ifInPackets and ifOutPackets statistics of a particular interface on the device, and sets the device into alarm or warning when the packet rate exceeds certain thresholds. It also gives a DOWN alarm if the interface's ifOperStatus is not equal to 1 (up).

The Port Number parameter is the ifIndex of the port to monitor.

The Warn Threshold and Alarm Threshold parameters are in packets per second.

Filename: com.dartware.snmp.pps.txt
Version: 0.5

Back to Top

SNMP > SNMP High Traffic

High Traffic Probe

This probe monitors the ifInOctets and ifOutOctets traffic statistics of a particular interface on the device, and sets the device into alarm or warning when the traffic exceeds certain thresholds. It also gives a DOWN alarm if the interface's ifOperStatus is not equal to 1 (up).

The Port Number parameter is the ifIndex of the port to monitor.

The Warn Threshold and Alarm Threshold parameters are in bytes per second.

Filename: com.dartware.snmp.traffic.txt
Version: 0.3

Back to Top

SNMP > SNMP High Util

High Utilization Probe

This probe monitors the utilization of ifInOctets and ifOutOctets traffic statistics of a particular interface on the device, and sets the device into alarm or warning when the traffic exceeds certain utilization thresholds.

It also gives a DOWN alarm if the interface's ifOperStatus is not equal to 1 (up).

The Port Number parameter is the ifIndex of the port to monitor.

The Warn Threshold and Alarm Threshold parameters are in percent of bandwidth utilization.

Filename: com.dartware.snmp.traffic-util.txt
Version: 0.2

Back to Top

SNMP > String Comparison

Comparison Probe

This probe retrieves a single SNMP MIB variable, compares it to a specified value, and sets the device's severity based on the comparison. It also displays the value in the Status Window.

Variable specifies the MIB name or OID for the value to retrieve. If you have imported the MIB for this device, you may enter the symbolic name for this value, otherwise, simply enter its OID here.

Test set the dropdown to indicate whether to alarm if the device is equal/not equal to the Value parameter.

Value is the value to compare against.

Severity for the device if the comparison isn't as expected.

Legend is a text string used to identify the variable in the status window and any strip charts. If left blank, the variable's name or OID will be used.

Units is an optional text string that will be displayed next to the value in the Status Window. You can use it for the unit of measure (packets/sec, degrees, etc.)

Tag is a short text string that identifies a particular class of dataset. Tags will be used to correlate different variables from different probes that describe the same thing, such as CPU% or temperature.

Filename: com.dartware.snmp.oidstrcomparison.txt
Version: 1.8

Back to Top

SNMP > Table Viewer

SNMP Table Viewer Probe

This probe displays the contents of several useful tables from common SNMP MIBs. It retrieves its data by walking the SNMP data values in the tables.

ifTable

The "Interfaces" table gives information about the physical and logical interfaces of the device. It displays the following columns: ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress, ifOperStatus, and ifAdminStatus. It is defined in MIB-II (RFC-1213) and updated in the IF-MIB.

ifXTable

The Extended Interfaces table defined in IF-MIB. This is an extended version of ifTable and adds the ifName and ifAlias fields/columns to those shown in the ifTable above.

Traffic Counters

This table displays the traffic counters: ifInOctets and ifOutOctets from the MIB-II ifTable, and the ifHCInOctets and ifHCOutOctets from the IF-MIB. To determine the traffic rate, refresh the window and compare two separate readings. The difference divided by the time between the refreshes (in seconds) will be the number of bytes/second.

tcpConnTable

Displays information about any connections that are present: Variables include tcpConnLocalAddress, tcpConnLocalPort, tcpConnRemAddress, and tcpConnRemPort. It is defined in MIB-II.

udpTable

Displays information about any UDP listeners that are present: Variables include udpLocalAddress, udpLocalPort. It is defined in MIB-II.

ipAddrTable

This table displays the IP address/mask/broadcast address for each interface. Includes ipAdEntAddr, ipAdEntifIndex, ipAdEntNetMask, ipAdEntBcastAddr, and ipAdEntReasmMaxSize. It is defined in RFC-1213, and updated in the IP-MIB.

ipRouteTable

This table (currently deprecated) comes from RFC-1213 (MIB-II).

ipCidrRouteTable and ipForwardTable

These tables come from the IP-FORWARD-MIB, which displays information about CIDR multipath IP Routes. Note: the ipForwardTable obsoletes the ipRouteTable of MIB-II, and is in turn obsoleted by the ipCidrRouteTable.

ipNetToMediaTable

The Net Address to Media Address table (also known as the "ARP Table") displays these fields/columns: ipNetToMediaIfIndex, ipNetToMediaNetAddress, ipNetToMediaPhysAddress, and ipNetToMediaType. It is defined in RFC-1213.

dot1dTpFdbTable

The "Bridge MIB" (RFC1493) displays the forwarding database for transparent bridges.

The Status Window contains links to each of these tables. Click the link to see the contents of the table on the selected device.

This probe requires that you first import these MIBs: RFC1213-MIB (MIB-II), Bridge MIB (rfc1493), IP-MIB (rfc2011), IF-MIB (rfc2863), and IP-FORWARD-MIB (rfc2096). These are all bundled together in a single zip archive.

Filename: com.dartware.snmp.tableviewer.txt
Version: 1.8

Back to Top

SNMP > Trap Viewer

Trap Viewer Probe

This probe listens for trap packets to arrive and displays the contents of the trap in the Status Window. It does not actively poll the device, nor does it take any action based on the trap contents.

You can view all the variables that have been parsed from the trap packet in the device's Status Window. You can also use this as a prototype for making your own trap probes.

How the Trap Viewer Probe Works

When a trap arrives, the probe parses the trap to get the values from the trap's header as well as the first ten items in its Varbind List. It assigns all these values to variables that can be used in the probe and displayed in the Status Window.

To see how this probe works, you can configure your equipment to send traps to InterMapper, or use the net-snmp snmptrap command. Either way, the Status Window will show the values present in any traps that arrive.

For more information on the snmptrap command, read the net-snmp documentation for the trap tutorial and the snmptrap command. The remainder of this note shows how to send a trap with variables from the Dartware MIB:

SNMPv1 Traps

a) Add a device to a map with the IP address 192.168.56.78

b) Set it to use this probe

c) Issue the snmptrap command below from the command line (it should all be on one line):

snmptrap -v 1 -c commString localhost

1.3.6.1.4.1.6306 192.168.56.78 6 123 4567890

1.3.6.1.4.1.6306.2.1.1.0 s "05/08 23:26:35"

1.3.6.1.4.1.6306.2.1.2.0 s Critical

1.3.6.1.4.1.6306.2.1.3.0 s "Big Router"

1.3.6.1.4.1.6306.2.1.4.0 s "Critical: High Traffic"

1.3.6.1.4.1.6306.2.1.5.0 s "127.0.0.1"

1.3.6.1.4.1.6306.2.1.6.0 s "SNMP Traffic Probe"

SNMPv2c Traps

a) Add a device to the map with an IP address of localhost

b) Set it to use this probe

c) Issue the snmptrap command below from the command line (it should all be on one line)

snmptrap -v 2c -c commString localhost

4567890 1.3.6.1.4.1.6306

1.3.6.1.4.1.6306 192.168.56.78 6 123 4567890

1.3.6.1.4.1.6306.2.1.1.0 s "05/08 13:26:35"

1.3.6.1.4.1.6306.2.1.2.0 s Critical

1.3.6.1.4.1.6306.2.1.3.0 s "Big Router"

1.3.6.1.4.1.6306.2.1.4.0 s "Critical: High Traffic"

1.3.6.1.4.1.6306.2.1.5.0 s "127.0.0.1"

1.3.6.1.4.1.6306.2.1.6.0 s "SNMP Traffic Probe"

Filename: com.dartware.snmp.trapdisplay.txt
Version: 2.2

Back to Top