Skip to main content
TLS certificate probes connect to a host on a TLS port, read the peer certificate, and report days_until_expiry. Use them to fire a clear signal before a public certificate lapses.

Configuration shape

Field reference

The probe accepts certificates that fail validation (expired, self-signed, hostname mismatch). The intent is to surface the problem rather than refuse the connection. Status is computed from days_until_expiry.

Threshold examples

An expired certificate reports 0. Set unhealthy at under 1.

Reason codes

The full catalog, with the hint the console shows for each code, is in Reason codes.
IP literalsWhen host is an IP literal, the SNI hint is omitted (RFC 6066 forbids IPs as SNI values). Some virtual-hosted servers will not return the expected certificate without SNI. Probe a hostname whenever the system supports one.