table of contents Table of contents
Docs / Tcp checks
CLI Enabled

Monitoring your services with TCP checks

On this page

Early Access Feature: This feature is available in early access and is currently UI-only. To enable it, please reach out to our support team or connect with us via the Checkly community Slack. We’d love to hear your feedback!

Overview

A TCP check establishes a connection to a specified hostname or IP address and port to verify that the service is responsive. These checks are ideal for monitoring non-HTTP services, such as databases, message queues, and custom applications that rely on TCP connectivity.

Create a TCP check

  • Create a check: Click the + icon on the sidebar and select TCP check from the list. This will open the check creation page.

  • Name & tags: On the check creation page, choose a meaningful name for the check to easily identify it. Optionally, add one or more tags to further categorize or group the check.

  • The TCP request: Configure the TCP endpoint to monitor by specifying a hostname or IP address (e.g., tcpbin.com or 192.168.1.1) and a port (e.g., 4242).

  • Set response time limits: Define thresholds for marking the check as degraded or failed. This allows you to specify when requests should be considered slow (degraded) or entirely unreachable (failed).

  • Scheduling strategy & locations: Choose a scheduling strategy and which location you would like to run your TCP check from. Please note that private locations are not yet supported for TCP checks but will be available soon.

  • Scheduling: Schedule your checks to run at intervals between 10 seconds (minimum) and 24 hours (maximum).

  • Retries & alerting: Configure retries & alerts by choosing from Checkly’s retry strategies and alert channels, ensuring you’re notified through your preferred methods when an issue arises with one of your TCP checks.

Update or delete a TCP check

  • Update a TCP check: To update a TCP check, click the kebab menu (three dots) next to the check on your main dashboard and select Edit, or click Edit in the top-right corner of the check’s Reporting page.

  • Delete a TCP check: To delete a TCP check, use the kebab menu (three dots) on the main dashboard and select Delete. Alternatively click Edit in the top-right corner of the check’s Reporting page, scroll to the bottom section, and click the Delete button.

TCP check reporting

Learn more about analyzing your TCP check run results in our check results documentation.

Last updated on December 20, 2024. You can contribute to this documentation by editing this page on Github