Skip to content

Concepts Checks Ping

Arael Espinosa edited this page Jul 9, 2026 · 1 revision

Ping Check

The Ping check sends an ICMP echo request (ping) to a host and checks whether it responds. It's the most basic connectivity check — useful for verifying raw network reachability before testing higher-level protocols.

Source: PingCheckExecutor.cs · PingCheckData.cs

What it verifies

  • The host is reachable via ICMP
  • The round-trip time is within the timeout

Common use cases

Server reachability

{ "host": "10.0.0.1" }

External host with tighter timeout

{ "host": "8.8.8.8", "timeout": 2000 }

Note: Many cloud providers and firewalls block ICMP. If Ping fails but TCP/HTTP checks pass, ICMP is likely filtered at the network level. In those cases, use a TCP check instead.

Configuration

Field Default Description
host Hostname or IP to ping (required)
timeout 5000 Milliseconds before the ping is considered timed out

Statuses

Status When
UP ICMP echo reply received (IPStatus.Success)
DOWN No reply, host unreachable, or any other ICMP failure status
FAILURE Host not configured

Latency

Taken from the ICMP reply's round-trip time (PingReply.RoundtripTime). Reported as null if the ping fails.

Related

  • Checks — common settings (schedule, thresholds, criticality)
  • TCP Check — use TCP to check a specific port when ICMP is blocked

Clone this wiki locally