Skip to content

TCP / port monitor

Check that any TCP port accepts connections — databases, brokers, mail, SSH and custom protocols.

Last updated

The TCP monitor (shown in the dashboard as Port (TCP)) opens a TCP connection to a host and port and records whether the handshake completed and how long it took. Use it for anything that listens on a port but does not speak HTTP.

What each check records

  • Statusup if the three-way handshake completed, down otherwise.
  • Latency — connection time in milliseconds, including DNS resolution.

The check does not send or read any application bytes. If a process is bound to the port but wedged, TCP still reports up. Pair it with an HTTP monitor when you need service-level health.

Configuration

OptionNotes
HostHostname or IP. DNS is resolved on every check.
Port1–65535.
IntervalHow often to check. Your plan sets the floor.

The connection timeout is fixed at 3 seconds and is not configurable per monitor.

TCP or HTTP?

ScenarioMonitor
Web service with a health endpointHTTP
Postgres, MySQL, Redis, MongoDB accepting connectionsTCP
SMTP, IMAP, SSH, FTPTCP
Custom binary or line protocolTCP
Anything needing an application-level verdictHTTP

If both matter — a Postgres server that also fronts PgBouncer on another port — create two monitors.

Common ports

ServicePort
SSH22
SMTP25, 587
HTTP / HTTPS80 / 443
LDAPS636
IMAPS993
MySQL3306
RDP3389
PostgreSQL5432
Redis6379
MongoDB27017

Example

A Postgres replica on db-replica-1.internal:5432:

example
Type:     Port (TCP)
Host:     db-replica-1.internal
Port:     5432
Interval: 60s
Firewalls and private networks

A TCP monitor only verifies the port is reachable from the checking node's network path. If the service sits behind a private network or an allowlist, either allowlist the checking node or run a dedicated node inside your own network. Dedicated nodes are available on Starter and above — 1 on Starter, 3 on Growth, unlimited on Scale.

TLS

A TCP monitor stops at the TCP handshake — it does not negotiate TLS and it cannot tell you anything about a certificate. To track certificate validity and expiry, use the SSL & domain expiry monitor.

Limitations

  • No application-level assertions — no banner matching, no EHLO, no STARTTLS probing.
  • Connection refused counts as down, even when refusing is the correct behaviour for that source IP. If your service rejects non-allowlisted addresses, allowlist the node or use a dedicated one.
  • No port-knocking or multi-stage handshakes.
  • No UDP.

See also