Man Page: bsnmp-ping(8)

bsnmp-ping(8)             BSD System Manager's Manual            bsnmp-ping(8)

NAME
     bsnmp-ping - an SNMP module which measures latency and reachability to
     hosts over a time period.

DESCRIPTION
     bsnmp-ping is a module for bsnmpd(1) which allows you to measure latency
     and reachability. It sends out ICMP packets to the configured hosts. A
     history of received packets is maintained, and you can query via SNMP how
     many dropped packets, maximum/minumum latency and other stats for that
     history period.

MIBS
     The counters will be available as a table under the following MIB:

            .1.3.6.1.4.1.12325.1.204

     Or if the appropriate MIB.txt files have been installed:

            enterprises.fokus.begemot.ping

     The following SNMP MIBs are available for use (where X is the counter
     index):

     ping.pingCount
                 The number of hosts to ping.

     ping.pingEntry.pingIndex.X
                 The index of the host.

     ping.pingEntry.pingHost.X
                 The host (address) to which ICMP packets are being sent.

     ping.pingEntry.pingInterval.X
                 The interval (in TimeTicks, 100th of a second) between sent
                 ICMP packets.

     ping.pingEntry.pingHistory.X
                 The time period (in pingInterval units, above) that history
                 for received ICMP packets is maintained.

     ping.pingEntry.pingResponses.X
                 The number of responses received in the (pingHistory) time
                 period.

     ping.pingEntry.pingDropped.X
                 The number of dropped packets in the (pingHistory) time
                 period.

     ping.pingEntry.pingLatencyAvg.X
                 The average latency (ms) of ICMP responses in the time
                 period.

     ping.pingEntry.pingLatencyMin.X
                 The minimum latency (ms) of ICMP responses in the time
                 period.

     ping.pingEntry.pingLatencyMax.X
                 The maximum latency (ms) of ICMP responses in the time
                 period.

OPTIONS
     To activate the bsnmp-ping module you must load the module in
     /etc/snmpd.config and configure the location for the UNIX socket and
     bsnmp-regex.conf(5)

     Use the pingHost, pingInterval, and pingHistory SNMP MIBs in the file to
     setup the hosts you'd like to ping.

EXAMPLES
     The following example pings two hosts. The first gets pinged once per
     second, and keeps a history for 300 seconds. The second is pinged 5 times
     per second, and the history is kept for 30 seconds.

     The following would be added to /etc/snmpd.config:

           begemotSnmpdModulePath."ping" = "/usr/local/lib/snmp_ping.so"
           %ping
           pingHost.1 = "10.8.9.2"
           pingInterval.1 = 100
           pingHistory.1 = 300

           pingHost.2 = "2.2.2.2"
           pingInterval.1 = 20
           pingHistory.1 = 150

SEE ALSO
     bsnmpd(1)

AUTHOR
     Stef Walter <stef@thewalter.net>

bsnmp-ping                       April 7, 2006                      bsnmp-ping
   [ back | home ]