Kener Docs
llms.txt
Search Documentation
Search through all documentation pages
Core Concepts

Ping Monitor

Monitor host reachability and latency with ICMP checks

Ping monitors run ICMP checks against one or more hosts and evaluate the combined result.

Minimum setup

Add at least one host entry with:

  • type: IP4 or IP6
  • host
  • timeout (ms)
  • count (number of ping packets)

Configuration fields

Field Type Default Notes
hosts Array<{type,host,timeout,count}> one empty host row Required
pingEval string (JS function) built-in default Optional

Default host values: type=IP4, timeout=1000, count=3.

Default eval behavior

Default logic:

  • UP if all hosts are alive
  • DOWN otherwise
  • latency = average latency across hosts

Custom eval contract

Function input:

  • arrayOfPings

Return object:

{ status: "UP" | "DEGRADED" | "DOWN" | "MAINTENANCE", latency: number }

Example

{
    "type": "PING",
    "type_data": {
        "hosts": [{ "type": "IP4", "host": "8.8.8.8", "timeout": 1000, "count": 3 }]
    }
}

Troubleshooting

  • Validation fails: host type must match detected address type
  • Frequent DOWN: some networks/firewalls block ICMP
  • Noisy latency: increase count or timeout to reduce false negatives