DigiCert KnowledgeBase - Technical Support-hero

Knowledge Base

Add a TCP Check

Solution ID : SO297
Last Modified : 10/21/2023

How to Add a TCP Check

1. Create a TCP Check
First, we will create the TCP check by clicking on the “Add Checks” drop-down menu on the right and selecting the “TCP Check” option.

2. Name
Next, give your check a unique name that will help you easily identify the check. For example, you could name your check after the host or IP you are making the check for.

3. Version/Host/Port

a) Version - Select the IP version you will be running the check against.

b) Host - Add the "Host Name" or "IP Address" you would like to check.

c) Port - Enter the port number you would like our monitors to run the check against. 

4. Interval
Choose how often you want our monitoring nodes to check the status of your endpoint. Keep in mind, if you choose a shorter time, the more costly it will be. Also, consider that the more monitoring locations you choose will reduce the interval time if you choose the “Once per Site” or “Once per Region” interval policies.

Since we are running checks from multiple locations at each interval, the interval period is actually reduced to Interval/Monitoring Locations and can be as short as a fraction of a second.

5. Interval Policy
Choose how many locations are checked at each check interval.

All Agents Per Interval - All selected agents will initiate a check simultaneously at each check interval. For example, if you have 5 selected agents with a 30-second interval, a check will run from all 5 agents every 30 seconds. 

One Agent Per Interval - A check will run from an individual agent at each check interval.  For example, if you have 5 agents selected with a 30-second interval, one check will be run from one of the selected agents every 30 seconds. 

One Agent Per Region Per Interval - A check will be run from one agent in all selected Regions per interval. For example, if you have 2 agents selected in all 6 regions with a 30-second interval, a check will be run from one agent in each selected region every 30 seconds.

6. Verification Policy
Next, select a policy that will determine how agents will decide if a check is UP or Down. 

Simple When a monitoring node detects an endpoint as down, we will also check from a nearby location to verify. If the verification confirms the original report we will consider the check as Down. 

Majority - Determine whether the check is UP or DOWN based on what the majority of the selected agents are reporting. Note: We recommend that you select at least 3 agents if you chose this option. 

7. Select Agents
Select monitoring agents by clicking on "View or Select Monitor Agents". 

Then check the box next to the agent you would like to monitor your site. You can select an entire region by checking the box next to that region. 

8. Contact Groups
These are pre-configured groups of contacts that you can define within the Contacts Groups. All users in the chosen group(s) will be notified of UP/DOWN status changes, but only when they are scheduled to receive alerts.

If you would like to receive a notification when the status of a check changes you can select from one of the "Contact Groups" you have created. If you do not have a contact group and would like to create one please follow the following tutorials. 

Here is the tutorial for creating a Contact Group.

Here is a tutorial for creating a Contact

9. Notification Report
The notification report allows you to define the amount of time you would like the notification report to be available after an event or check status change has taken place. 

Whenever a check is detected as DOWN, we will send an email with a notification report attached displaying information regarding the outage. 

10. Optional Programs
For more customization options select the "Optional Programs" tab. Here you will be able to add a string for our monitoring nodes to send, and an optional string to receive. 

11. Maintenance Window
Additionally, if you have any set dates and times you routinely perform maintenance on your host/IP and would like to disable Sonar monitoring during these times you can select the "Maintenance Window" tab and set the date, start time, and end time.

12. Test Check
Once you are finished configuring the check you can test it by clicking on "Test Check" and selecting the location you would like to run the check from. This will run the check you just configured from the location you selected.