ping
Use case
Basic network reachability and round-trip time to a host. Uses a native
ICMP echo implementation - no dependency on an external ping binary, and
runs unprivileged by default (no root/Administrator needed).
Configuration
| Field | Type | Meaning |
|---|---|---|
host |
string | required - remote host/IP to ping |
A single echo request, 2s timeout. If your platform’s unprivileged ICMP is
locked down, use root_required: yes (see
Configuration) to
only run the check when elevated.
Output
| Item | Type | Meaning |
|---|---|---|
ping |
string | the configured host (tag) |
ping_rtt |
float (ms) | round-trip time (datapoint) |
ping_ip |
string | resolved IP address (datapoint) |
Example
checks:
- module: ping
name: vm3
conf:
host: 192.168.0.3
severity_max: warning