Skip to content

This plugin is for Craft CMS v2, which is no longer supported.

License

Notifications You must be signed in to change notification settings

benjamin-smith/craft-healthcheck

Repository files navigation

Health Check plugin for Craft CMS v2

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:

  1. 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

  1. 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.

About

This plugin is for Craft CMS v2, which is no longer supported.

Resources

License

Stars

Watchers

Forks