Craft CMS
DocsWhat each check measures, when it trips, and how to change it.
Every poll runs each enabled check and reports the worst result as the site's status: Healthy, Degraded or Unhealthy. Each check includes the thresholds it used, so you can see in Ledge exactly why a site tripped. If a check fails to run, it reports Unhealthy with "Check threw an exception" rather than hiding the problem.
Use the check name to turn a check off. Threshold and status settings are in Configuration.
Name: queue
Reports waiting, failed and stale jobs in Craft's queue. A job is stale when it has been waiting longer than queueStaleAfter (5 minutes by default) and nothing has picked it up. That's usually a sign the queue runner has stopped.
queueFailedDegradedAt or queueStaleDegradedAt to use it.This check reads Craft's standard database queue. If the site uses a different queue driver, the check reports Healthy with "Non-standard queue driver in use" and doesn't measure anything.
Names: formie, freeform
These only run when the plugin is installed.
Both are Degraded at 1 and Unhealthy at 11. The counts aren't limited to a time window, so clear old failures in Formie or Freeform once you've dealt with them.
Name: disk
Percentage used on the volume that holds Craft's storage folder.
diskMinFreeBytes to also go Unhealthy below a fixed amount of free space, whatever the percentage.Name: memory
How much of PHP's memory_limit the health request itself uses. It catches a limit set too low for the site, not the server's total RAM.
memory_limit is -1 (no limit).Name: database
Runs a simple query and reports how long it took. Unhealthy if Craft can't connect. Response time is reported but never changes the status.
Names: craftVersion, plugins
The installed and latest versions of Craft and every plugin, with release notes and whether each update is critical.
criticalUpdateStatus).updateAvailableStatus).The plugin uses Craft's cached update information, so it doesn't add requests to Craft's update servers on every poll.
Name: license
Unhealthy by default when the Craft licence or any plugin licence is invalid or doesn't match the site, or when the Craft edition in use doesn't match the licence. Change it with licenseIssueStatus.
Name: phpVersion
Where your PHP version is in its support life.
| Phase | Default status |
|---|---|
| Active support | Healthy |
| Security fixes only | Degraded (phpSecurityOnlyStatus) |
| End of life | Unhealthy (phpEolStatus) |
| Within 90 days of end of life | Unhealthy (phpEolUnhealthyWithinDays) |
PHP 8.2 stops getting security fixes on 31 December 2026, so sites on 8.2 already report Unhealthy under the 90-day rule. Upgrade PHP, or set phpEolUnhealthyWithinDays to a smaller number while you plan it.
Name: debugMode
Degraded when devMode is on (devModeStatus). It also reports whether allowAdminChanges is on, without affecting the status.
Name: environment
Looks for environment variables your Craft config reads that aren't set, in config/general.php, db.php, app.php, app.web.php and app.console.php. Degraded when any are missing (missingEnvVarsStatus). A variable set with a CRAFT_ prefix counts. List any you expect to be missing in ignoredEnvVars.
This check also reports the PHP version, operating system and database server version you see in Ledge.
Name: failedLogins
The number of users with failed login attempts in the last 24 hours (failedLoginsWindow). Degraded at 10 users, Unhealthy at 50.