benjamin-smith / craft-healthcheck
Adds a health check route to your site to indicate that Craft is health and ready to accept web traffic from a load balancer.
Installs: 95
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 1
Forks: 2
Open Issues: 1
Type:craft-plugin
Requires
- composer/installers: ~1.0
This package is not auto-updated.
Last update: 2024-12-21 21:19:43 UTC
README
Adds a health check route to your site to indicate that Craft is healthy and ready to accept web traffic from a load balancer.
DEPRECATED
This plugin is for Craft CMS v2, which is no longer supported. See https://craftcms.com/knowledge-base/supported-versions
Installation
To install, follow these steps:
- Install with Composer (recommended)
composer require benjamin-smith/craft-healthcheck
-OR- download & unzip the codebase and place the healthcheck
directory into your craft/plugins
directory
- Install plugin in the Craft Control Panel under Settings > Plugins
Configuration
The default configuration file explains the various options that are available, and uses sensible defaults that do not necessarily require modification.
To customize the config, copy that file to craft/config/healthcheck.php
and modify as needed.
Usage
Once installed and configured, your health check URL should be responding to requests as expected (the default url is http://mydomain.com/health-check). If the site goes offline for any reason, a non 200 HTTP status code should be returned, which your load balancer should take as a signal to remove this site/server from the load balancer rotation.
Roadmap
- Allow for whitelisting IP ranges using CIDR block notation.