Watchdog: TCP Port
Checks whether a TCP port accepts connections. No data is sent. Type tcp_port, runner Dashboard or Agent. Fields, defaults, statuses and messages.
Watchdog: TCP Port
The check opens a TCP connection to host and port and closes it right away. No data is sent or read.
| Property | Value |
|---|---|
| Type identifier | tcp_port |
| Runner | Dashboard or Agent |
| Target in the email | Host:Port |
Fields
| Field | Key | Default | Meaning |
|---|---|---|---|
| Host | host |
Required. Host name or IPv4 address. IPv6 addresses are not supported | |
| Port | port |
80 |
Required. Port number from 1 to 65535 |
| Timeout (seconds) | timeout |
5 |
Connection time limit, clamped to 1 to 60 seconds |
Behaviour
| Situation | Status | Message |
|---|---|---|
| Connection succeeds | OK |
<host>:<port> reachable |
| Connection fails | FAIL |
Connection to <host>:<port> failed: <reason> |
| Invalid port | UNKNOWN |
Invalid port configured |
| No host | UNKNOWN |
No host configured |
Which machine connects depends on the runner: the worker container for the Dashboard runner, the agent for the Agent runner. A port that is open only locally on the server may not be reachable from the dashboard.