This check uses the system ping command to test the reachability of a host. It also optionally measures the round-trip time for messages sent from the check to the destination host.
Ping operates by sending Internet Control Message Protocol (ICMP) echo request packets to the target host and waiting for an ICMP echo reply.
This check uses the system ping command, rather than generating the ICMP echo request
itself, as creating an ICMP packet requires a raw socket, and creating raw sockets
requires root privileges, which the Agent does not have. The ping command uses the
setuid access flag to run with elevated privileges, avoiding this issue.
The Ping check is NOT included in the Datadog Agent package.
If you are using Agent v6.8+ follow the instructions below to install the Ping check on your host. See our dedicated Agent guide for installing community integrations to install checks with the Agent prior to version 6.8 or the Docker Agent:
Clone the integrations-extras repository:
git clone https://github.com/DataDog/integrations-extras.git.
ddev config with the
ddev config set extras ./integrations-extras
To build the
ping package, run:
ddev -e release build ping
Run the following command to install the integrations wheel with the Agent:
sudo -u dd-agent datadog-agent integration install -w <PATH_OF_PING_ARTIFACT_>/<PING_ARTIFACT_NAME>.whl
Configure your integration like any other packaged integration.
ping.d/conf.yaml file, in the
conf.d/ folder at the root of your
Agent’s configuration directory to start collecting your ping performance data.
See the sample ping.d/conf.yaml for all available configuration options.
Run the Agent’s status subcommand and look for
ping under the Checks section.
|The response time of a given host and ping port, tagged with url, e.g. 'host:192.168.1.100'.|
Shown as millisecond
|Value of 1 if the agent can successfully communicate with the target host, 0 otherwise|
CRITICAL if the Agent cannot communicate with the target host. Returns
OK if the ping is successful.
The Ping check does not include any events.
Need help? Contact Datadog support.
Mistake in the docs? Feel free to contribute!