Basic OID
This probe lets you monitor a single, user-defined MIB variable.
Parameters
Object Name - optional - The name of the value that you want to monitor. This parameter value is used only for display in the popup window and chart legend.
Object ID - The object identifier (OID) of the value that you want to monitor. 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 just want to monitor a single SNMP variable, use the SNMP/Single OID probe.
Filename: com.dartware.snmp.basic
Version: 0.8
Comparison
This probe retrieves a single SNMP MIB variable, compares it to a specified value, and uses the result to set the device's status. It also displays the value in the Status Window.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Test - Choose whether to set the status to ALARM if the device is Equal or NotEqual to the Value parameter.
Value - The value to compare against.
Severity - The status to use if the comparison fails.
Legend - 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 is used.
Units - optional - A text string that is displayed next to the value in the Status Window, intended for use as a unit of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidcomparison.txt
Version: 1.11
High Threshold
This probe retrieves a single SNMP MIB variable and compares it to the specified thresholds below. If the value goes above any of the specified thresholds, the device changes to the specified state.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Critical, Alarm, and Warning - the threshold to be used for comparison for each severity. Thresholds may be positive or negative numbers.
Legend - a text string used to identify the variable in the status window and in strip charts. If left blank, the variable's name or OID is used.
Units - a text string displayed next to the variable's value in the Status Window. Usually used for units of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidhigh.txt
Version: 1.6
Low Threshold
This probe retrieves a single SNMP MIB variable and compares it to the specified thresholds below. If the value goes below any of the specified thresholds, the device changes to the specified state.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Critical, Alarm, and Warning - the threshold to be used for comparison for each severity. Thresholds may be positive or negative numbers.
Legend - a text string used to identify the variable in the status window and in strip charts. If left blank, the variable's name or OID is used.
Units - a text string displayed next to the variable's value in the Status Window. Usually used for units of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidlow.txt
Version: 1.6
Range Threshold
This probe retrieves a single SNMP MIB variable and compares it to the specified thresholds. If the value goes outside the specified range, the device changes to the corresponding state.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Critical, Alarm, and Warning - the threshold to be used for comparison for each severity. Thresholds may be positive or negative numbers.
Legend - a text string used to identify the variable in the status window and in strip charts. If left blank, the variable's name or OID is used.
Units - a text string displayed next to the variable's value in the Status Window. Usually used for units of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidrange.txt
Version: 1.7
Restricted Interface
This probe is identical to the Basic SNMP Traffic probe, except that it restricts the visible interfaces to those that match the specified Interface Description.
Parameters
Interface Description - specifies the interfaces to display. Any interface with a value of ifDescr that matches this pattern is visible on the map. Non-matching interfaces are hidden.
Filename: com.dartware.snmp.restrictedint.txt
Version: 0.2
Single OID Viewer
This probe retrieves a single SNMP MIB variable and displays it in the device's Status Window.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Legend - a text string used to identify the variable in the status window and in strip charts. If left blank, the variable's name or OID is used.
Units - a text string displayed next to the variable's value in the Status Window. Usually used for units of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidsingle.txt
Version: 1.5
SNMP - High PPS
This probe monitors the ifInPackets and ifOutPackets statistics of the specified device interface, and sets the state of the device to Alarm or Warning when the packet rate (in packets/second) exceeds specified thresholds. It sets the state to Down if the interface's ifOperStatus is not equal to 1 (Up).
Parameters
Port Number - the ifIndex of the port to monitor.
Warn Threshold and Alarm Threshold - threshold values in packets-per-second.
Filename: com.dartware.snmp.pps.txt
Version: 0.6
SNMP - High Traffic
This probe monitors the ifInOctets and ifOutOctets traffic statistics of a particular interface on the device, and sets the device to Alarm or Warning when the traffic exceeds specified thresholds. It sets the device's state to Down if the interface's ifOperStatus is not equal to 1 (up).
Parameters
Port Number - The ifIndex of the port to monitor.
Warn Threshold and Alarm Threshold - Thresholds in bytes per second.
Filename: com.dartware.snmp.traffic.txt
Version: 0.4
SNMP - High Util
This probe monitors the utilization of ifInOctets and ifOutOctets traffic statistics of a particular interface on the device, and sets the device to Alarm or Warning when the traffic exceeds specified utilization thresholds. It sets the device's state to Down if the interface's ifOperStatus is not equal to 1 (up)
Parameters
Port Number - The ifIndex of the port to monitor.
Warn Threshold and Alarm Threshold - Threshold, specified as a percentage of bandwidth utilization.
Filename: com.dartware.snmp.traffic-util.txt
Version: 0.3
String Comparison
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.
Parameters
Variable - the MIB name or OID to retrieve. If you have imported the MIB for this device, enter the symbolic name for this value. Otherwise, enter its OID.
Test - choose whether the device is equal to the Value parameter or not.
Value - the value to compare with the MIB variable's value.
Severity - choose severity level to use if the value does not match the specified value.
Legend - a text string used to identify the variable in the status window and in strip charts. If left blank, the variable's name or OID is used.
Units - a text string displayed next to the variable's value in the Status Window. Usually used for units of measure (packets/sec, degrees, etc.)
Tag - A short text string that identifies a particular class of dataset. Tags are used to correlate different variables from different probes that describe the same type of data, such as CPU% or temperature.
Filename: com.dartware.snmp.oidstrcomparison.txt
Version: 1.9
Table Viewer
This probe shows 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 shows 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. It adds the ifName and ifAlias fields/columns to those shown in ifTable above.
- Traffic Counters - Shows 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) is the number of bytes/second.
- tcpConnTable - Shows information about any present connections: Variables include tcpConnLocalAddress, tcpConnLocalPort, tcpConnRemAddress, and tcpConnRemPort. It is defined in MIB-II.
- udpTable - Shows information about any present UDP listeners: Variables include udpLocalAddress, udpLocalPort. It is defined in MIB-II.
- ipAddrTable - Shows 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, and show information about CIDR multi-path 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") shows these fields/columns: ipNetToMediaIfIndex, ipNetToMediaNetAddress, ipNetToMediaPhysAddress, and ipNetToMediaType. It is defined in RFC-1213.
- dot1dTpFdbTable - The "Bridge MIB" (RFC1493) shows the forwarding database for transparent bridges.
A link to each table appears in the Status Window. 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.
Parameters
None.
Filename: com.dartware.snmp.tableviewer.txt
Version: 1.9
Trap Viewer
This probe listens for trap packets and displays the contents of a trap in the Status Window. It does not actively poll the device, and takes no action based on the contents of the trap.
All variables parsed from the trap packet appear in the device's Status Window. You can use this probe 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 retireve the values from the trap's header, along with the first ten items in its Varbind List. Each value is assigned to a variable for use by the probe; each is also shown 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 shows the values present in any traps that arrive.
For more information on the snmptrap command, see 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"
Notes:
- This probe file contains the lines above in a single-line format suitable for copying and pasting.
- The parameters in this probe are unused, but could be used to set thresholds for various alarms.
Parameters
MinValue - Unused
MaxVAlue - Unused
Filename: com.dartware.snmp.trapdisplay.txt
Version: 2.3