5.33. ping_icmp

The ping_icmp module provide ICMP checks against targets. It sends a series of ICMP requests and waits for their responses tallying their turn-around time.

loader

C

image

ping_icmp.so

5.33.1. Module Configuration

5.33.2. Check Configuration

interval
required

optional

default

2000

allowed

\d+

The number of milliseconds between ICMP requests.

count
required

optional

default

5

allowed

\d+

The number of ICMP requests to send during a single check.

avail_needed
required

optional

default

100

allowed

\d+

The percentage of ICMP available required for the check to be considered "good." By default, 100% of the ICMP requests must have responses for a good state.

Example 5.34. Ping checks against a host

Ping 4.2.2.1 once a second for ten seconds recurring every 60 seconds.

      <noit>
        <modules>
          <module image="ping_icmp" name="ping_icmp"/>
        </modules>
        <checks>
          <ping module="ping_icmp" period="60000">
            <config>
              <count>10</count>
              <interval>1000</interval>
            </config>
            <check uuid="5b9fab60-77d4-11dd-99a4-97df794be4c8" target="4.2.2.1"/>
          </ping>
        </checks>
      </noit>