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
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
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
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
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
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
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
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
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
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
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
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
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