Observer
Observer Agent

Configure TCP probes

Open a TCP connection and report connect time as the metric value.

TCP probes are appropriate for non-HTTP services where reachability of a port is the signal: Redis, Postgres, RabbitMQ, internal RPC services. The agent opens a TCP connection, records the connect time in milliseconds, and closes the connection.

Configuration shape

{
  "host": "redis.internal",
  "port": 6379,
  "timeout_ms": 2000
}

Field reference

FieldDefaultNotes
hostrequiredHostname or IP.
portrequiredInteger in 1..65535.
timeout_ms2000Aborts the connection attempt when exceeded.

Reason codes

ReasonMeaning
ETIMEDOUTConnection attempt did not complete within timeout_ms.
ECONNREFUSEDTCP connection refused.
ENOTFOUND / EAI_AGAINDNS resolution failed.
tcp_errorOther socket error. The exact code is logged on the agent.

Threshold examples

GoalHealthyUnhealthy
Reachable + fast handshakeunder 50over 500
Reachableunder 1000over 1500

Pure reachability with no latency requirement: set unhealthy at timeout_ms - 1, leaving anything below as healthy.

Was this page helpful?