how-to · watch Open this in the console

Check that a host answers a ping.

Health › checks. Pick Ping a host. The agent pings that address on a schedule. You are still pushing a document, not a script.

Hosts used in ping checks are also sampled on the heartbeat, so the trends tab shows loss and average time.
01

Pick Ping a host and name the address

Open the machine, then health › checks. The primitive is Ping a host (ICMP). Host is the gateway, a server, or any address this machine should be able to reach — here, 10.1.1.1, the router on Accounts server. Packets is how many to send (1–10). Max loss is the percent that still counts as up. Max average milliseconds is optional. Add a disk or ping check is the same editor for free space.

Checks editor with a ping of 10.1.1.1, four packets, 25 percent loss
Accounts server. The gateway must answer. Not added yet.
02

Add to list, then push

Press add to list. The check sits in the document with the name you gave it. Push to agent is the next click, and it asks you to confirm. Push replaces the whole document. This shot stops before that, so nothing has been sent. When the host stops answering, or the loss is over the limit, the alert is a check failure. The same address then appears on the trends tab.

Checks list with a ping check named Gateway answers, not yet pushed
Gateway answers is on the list. Push has not been pressed.

Push is a two-step button. The agent must be online to evaluate. You can still add the check while it is offline, and it applies at the next hello. Free space is Add a disk or ping check. A name that must resolve is Check that a name resolves.