ping
check_ping
Checks the icmp ping connection.
Implementation
Windows |
Linux |
FreeBSD |
MacOSX |
✅ |
✅ |
✅ |
✅ |
Examples
Default Check
check_ping host=localhost
OK - Packet loss = 0%, RTA = 0.113ms |...
Example using NRPE and Naemon
Naemon Config
define command{
command_name check_nrpe
command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -n -c $ARG1$ -a $ARG2$
}
define service {
host_name testhost
service_description check_ping
use generic-service
check_command check_nrpe!check_ping!'warn=rta > 1000 || pl > 30' 'crit=rta > 5000 || pl > 80'
}
Argument Defaults
Argument |
Default Value |
filter |
none |
warning |
rta > 1000 || pl > 30 |
critical |
rta > 5000 || pl > 80 |
empty-state |
3 (UNKNOWN) |
empty-syntax |
%(status) - could not get any ping data |
top-syntax |
%(status) - ${list} |
ok-syntax |
|
detail-syntax |
Packet loss = ${pl}%{{ IF rta != ’’ }}, RTA = ${rta}ms{{ END }} |
Check Specific Arguments
Argument |
Description |
-4 |
Force using IPv4. |
-6 |
Force using IPv6. |
host |
host name or ip address to ping |
packets |
number of ICMP ECHO packets to send (default: 5) |
Attributes
Filter Keywords
these can be used in filters and thresholds (along with the default attributes):
Attribute |
Description |
host_name |
host name ping was sent to. |
ttl |
time to live. |
sent |
number of packets sent. |
received |
number of packets received. |
rta |
average round trip time. |
pl |
packet loss in percent. |