Skip to content

Ping

Function: PING

The PING function sends an ICMP ping to a given host to verify network reachability and responsiveness from the test device.

The step reports round-trip time, jitter and packet loss. Mobile data is switched on first.

Supported on: Android only.

Prerequisite

The NetDiag app (com.netdiag.app) must be installed on the phone. Without it the step fails.

Parameters

Parameter Name Description Example Values Required Default Value
HOST The host to ping — a hostname or IP address. An http:// or https:// prefix is removed. 8.8.8.8, google.com Yes
TIMEOUT The maximum time to wait for a response, in seconds. Whole seconds, 0-3700. 5, 10, 30 Yes
EXPECT The expected result of the ping. SUCCESS when the host responds, FAIL when it should not. SUCCESS, FAIL Yes SUCCESS

Explanation of Fields

  • HOST: The target host the device will ping (hostname or IP address).
  • TIMEOUT: How long to wait for a reply before the step times out, in seconds.
  • EXPECT: Defines the expected outcome — SUCCESS if the host is reachable, FAIL if it should be unreachable.