From OpenNMS

(Redirected from MultiICMP)

Example of a StrafePing Graph (Using JRobin)

The StrafePing monitor (in OpenNMS since release 1.3.7) is a monitor which performs multiple ICMP echo (ping) requests and stores the response-time of each as well as the packet loss, in an RRD file.

(NOTE: In order to provide due credit, the graphing of this feature is an adaptation of the [SmokePing] tool developed by Tobias Oetiker).

StrafePing is enabled by default in capsd, using the ICMP Plugin for detection. However, to keep the disk load down on the NMS file system, StrafePing has been filtered out to a bare minimum of IP addresses (i.e., two addresses, from 10.1.1.1 to 10.1.1.10). Look in poller-configuration.xml for the package called 'strafer'.

Configuration

To configure StrafePing, you can edit the $OPENNMS_HOME/etc/poller-configuration.xml file (although the defaults are sane).

Secondly, you will be happier if you edit poller-configuration.xml. Look for '<package name="strafer" >' and edit the line which begins with '<include-range'. Mine says <include-range begin="0.0.0.1" end="255.255.255.255"/>

Service Parameters

Like all monitors, the service tag can take a number of parameters:

name: the name of the service, this should be StrafePing
interval: how often (in milliseconds) to perform a poll using this monitor
user-defined: whether or not this service is user-defined, used primarily in the UI
status: whether or not the monitor is enabled

Monitor-Specific Parameters

It takes the following monitor-specific parameters:

timeout: how long (in milliseconds) to wait before assuming that a packet has not responded
retry: the number of retries to attempt when a packet fails to respond in the given timeout
ping-count: the number of pings to attempt each interval
failure-ping-count: the number of pings that need to fail for the service to be considered down
wait-interval: how long to wait between each packet
rrd-repository: the location to write RRD data (generally, you will not want to change this from the default $OPENNMS_HOME/share/rrd/response)
rrd-base-name: the name of the RRD file to write (minus the extension, .rrd or .jrb)

Example Poller Configuration

 <package name="strafer" >
   <filter>IPADDR != '0.0.0.0'</filter>
   <include-range begin="0.0.0.1" end="255.255.255.255"/>
   <rrd step="300">
     <rra>RRA:AVERAGE:0.5:1:2016</rra>
     <rra>RRA:AVERAGE:0.5:12:1488</rra>
     <rra>RRA:AVERAGE:0.5:288:366</rra>
     <rra>RRA:MAX:0.5:288:366</rra>
     <rra>RRA:MIN:0.5:288:366</rra>
   </rrd>
   <service name="StrafePing" interval="300000" user-defined="false" status="on">
     <parameter key="retry" value="0"/>
     <parameter key="timeout" value="3000"/>
     <parameter key="ping-count" value="20"/>
     <parameter key="failure-ping-count" value="20"/>
     <parameter key="wait-interval" value="50"/>
     <parameter key="rrd-repository" value="/usr/share/opennms/share/rrd/response"/>
     <parameter key="rrd-base-name" value="strafeping"/>
   </service>
   <downtime interval="30000" begin="0" end="300000"/>     
   <downtime interval="300000" begin="300000" end="43200000"/> 
   <downtime interval="600000" begin="43200000" end="432000000"/>  
   <downtime begin="432000000" delete="true"/>         
 </package>