Healthchecks

RunHealthcheckJob runs HealthcheckService::run() for each site. The service checks HTTP availability, SSL expiration, WordPress version, and pending plugin updates. It prefers data from the WP Hoster Agent health endpoint when available; otherwise falls back to WP-CLI.

Checks performed

1. HTTP — GET https://{fqdn}, record status code and TTFB. If unreachable or 5xx, status = down, critical alert raised.
2. SSL — getSslDaysLeft() via stream_socket_client and openssl_x509_parse. If < 14 days, warning alert.
3. WordPress / plugins — If agent is enabled and token exists, fetchAgentHealthData() GETs /wp-json/wphoster/v1/health and uses wp_version, etc. Otherwise WP-CLI core version and plugin list --update=available --format=count (cached).

Key file

app/Services/Healthchecks/HealthcheckService.php

• run(Site) — Runs all checks, creates HealthcheckRun with status, http_status, ttfb_ms, ssl_days_left, wp_version, pending_updates_count, details_json
• fetchAgentHealthData(Site) — GET health endpoint with X-WPHoster-Token; returns parsed JSON or null
• getSslDaysLeft(fqdn) — Connects to ssl://fqdn:443, reads peer cert, parses validTo, returns days left

Scheduling

wphoster:run-healthchecks runs every 10 minutes (see routes/console.php).

Alerts