benjamin-smith/craft-healthcheck

There is no license information available for the latest version (v1.0.0) of this package.

Adds a health check route to your site to indicate that Craft is health and ready to accept web traffic from a load balancer.

v1.0.0 2016-10-26 18:51 UTC

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:

  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.