ICMP optionsedit
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 * * * * * *'
hosts
edit
A list of hosts to ping.
wait
edit
The duration to wait before emitting another ICMP Echo Request if no response is received. The default is 1 second (1s).