Skip to content
Docs

Port

On this page
  1. Settings
  2. When is it healthy?
  3. Examples
  4. Good to know

The Port sensor opens a TCP connection to a host and port and checks that it succeeds. Use it for services that do not speak HTTP — SMTP, SSH, a database listener, an SFTP server — or to make sure a port that should be closed stays closed.

In the wizard: Network → Port availability.

Settings#

Setting Description
Host Hostname, domain name or IP address — see Hosts and addresses.
Port TCP port number. Default 80.
Timeout Time allowed to connect, in milliseconds.
Up if port open On (default): healthy when the connection succeeds. Off: healthy when it is refused — to watch that a port is not exposed.

When is it healthy?#

When the TCP connection opens within the timeout (or, reversed, when it cannot).

Examples#

  • Warehouse — SFTP: sftp.warehouse.corvane.example, port 22, on the private agent of the warehouse site.
  • Back-office — Database not exposed: the public IP of the database server, port 5432, Up if port open off: an incident opens if the database ever becomes reachable from the internet.

Good to know#

A successful connection proves that something listens on the port, not that the service behind it works. For a database, prefer the SQL sensor; for a web service, HTTP.