The ICMP Checks tool is a troubleshooting tool that lets you determine if a remote host can be reached over the internet or not, tests connectivity between the network devices and also tests if there is any network delay or packet loss happened in your host.

Metrics measured in ICMP checks include: * Latency * Packet Loss

Steps to configure the ICMP check:

Log in to Atatus. Then choose Synthetics from the dashboard.

To create the New check click on Create a New Check and select New API/Web Check.

1. Define request:

i) Choose the type of request as ICMP method in the drop down menu.

ii) Define your request: * Provide the domain name or IP address to run your test on. * Enter the number of Pings to trigger per test session. By default, the number of Pings is set to four. Depending on your needs, you can alter this number up to ten.

define_request

iii) Give your ICMP check a name. Your checks will be better organized if you add tags, so you can find them more easily in the dashboard.

iv) Try running a sample check by clicking Test check.

2. Define assertions

Upon clicking the Test Check button, you are automatically prompted with a basic assertion about the response from your server. It provides an indication of whether a check has been successful.

define_assertions

Every assertion can be customized. If you want to define your own assertion:

i) Click the Add Assertion button.

ii) Select the type and add the values accordingly.

Here are the list of types, operators and value types available in assertions.

Type Property Operator Value Type
latency avg,max,min,stddev is,is less than,is less than or equal, is more than, is more than or equal Integer(in ms)
packet loss is,is less than,is less than or equal, is more than, is more than or equal Percentage(in %)
packet received is,is less than,is less than or equal, is more than, is more than or equal Percentage(in %)

3. Select Location

The locations can be selected one at a time or all at once. Select the respective location by clicking on the check box.

4. Set a frequency for testing

The frequency at which you want the check to run can be selected. The default frequency is once every minute.

5. Defining alert conditions

In defining alert conditions, you can make sure your check isn't triggered by intermittent network activity, so that you are only notified when your endpoint really has a problem.

There is a threshold amount of consecutive failures the location must experience before it is considered failed. You can set the retry count based on your preference.

Additionally, you can configure your check to notify when your endpoint goes down at a certain number of locations. The following alerting rule is set to send a notification if the check fails for three minutes on two different locations.

6. Notify your team

After creating alerts, specify any email address you want your check to send alerts to.

In addition, you can use integration channels such as Slack, PagerDuty, Microsoft Teams, webhooks and much more. Synthetic alerts are triggered after you set up the appropriate integration with the notification tools.

alert_notifications

To setup:

i) You can set up new notification channels here by clicking the Setup new notification channels button.

ii) In the Notification Channel section, click Create New Notification channel.

iii) Choose your desired channel type such as Slack, Teams, PagerDuty and so on.

iv) Provide all the necessary details.

v) Click on Create Channel.

Once you've completed your check, click on Create New Check.