TCP / Ping Monitoring

Beyond HTTP, CheckOps supports raw TCP and ICMP ping monitoring for infrastructure components that do not expose HTTP endpoints.

TCP MONITORING

TCP monitors verify that a specific port is accepting connections. This is ideal for databases, message queues, mail servers, and custom services.

CONFIGURATION

Parameter	Description	Default
host	Hostname or IP address	Required
port	TCP port number	Required
interval	Check frequency in seconds	60
timeout	Connection timeout in milliseconds	5000
regions	Array of region codes	All available

EXAMPLE USE CASES

Service	Host	Port
PostgreSQL	db.acme.com	5432
Redis	cache.acme.com	6379
RabbitMQ	mq.acme.com	5672
SMTP	mail.acme.com	587
Custom API	internal.acme.com	8443

ASSERTIONS

TCP monitors support the following assertions:

Type	Operators	Description
connection	succeeds, fails	Whether TCP handshake completes
response_time	less_than, greater_than	Connection time in ms

{
  "type": "tcp",
  "host": "db.acme.com",
  "port": 5432,
  "assertions": [
    { "type": "connection", "operator": "succeeds" },
    { "type": "response_time", "operator": "less_than", "value": 500 }
  ]
}

PING (ICMP) MONITORING

ICMP ping monitors measure basic network reachability and round-trip latency. Useful for monitoring network infrastructure, VPN gateways, and bare-metal servers.

CONFIGURATION

Parameter	Description	Default
host	Hostname or IP address	Required
interval	Check frequency in seconds	60
packet_count	Number of ping packets	3
timeout	Per-packet timeout in ms	3000
regions	Array of region codes	All available

RESPONSE DATA

Each ping check returns:

Field	Description
packet_loss	Percentage of lost packets
rtt_min	Minimum round-trip time in ms
rtt_avg	Average round-trip time in ms
rtt_max	Maximum round-trip time in ms
region	Region that executed the check

ASSERTIONS

{
  "type": "ping",
  "host": "gateway.acme.com",
  "assertions": [
    { "type": "packet_loss", "operator": "less_than", "value": 10 },
    { "type": "rtt_avg", "operator": "less_than", "value": 100 }
  ]
}

WHEN TO USE TCP VS PING

Scenario	Recommended
Verify a service is listening	TCP
Network reachability check	Ping
Database connectivity	TCP
VPN gateway status	Ping
Load balancer health	TCP (on service port)
Host-level monitoring	Ping