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 in milliseconds. |
| pl |
packet loss in percent. |