ICMP options

Also see Common monitor options.

The options described here configure Heartbeat to use ICMP (v4 and v6) Echo Requests to check the configured hosts. Please note that on most platforms you must execute Heartbeat with elevated permissions to perform ICMP pings.

On Linux, regular users may perform pings if the right file capabilities are set. Run sudo setcap cap_net_raw+eip /path/to/heartbeat to grant Heartbeat ping capabilities on Linux. Alternatively, one may grant ping permissions to the user Heartbeat runs as. To grant ping permissions in this way, run sudo sysctl -w net.ipv4.ping_group_range='myuserid myuserid'.

Other platforms may require Heartbeat to run as root or administrator to execute pings.

Example configuration:

- type: icmp
  id: ping-myhost
  name: My Host Ping
  hosts: ["myhost"]
  schedule: '*/5 * * * * * *'

A list of hosts to ping.

The duration to wait before emitting another ICMP Echo Request. The default is 1 second (1s).