codemonauts/craft-healthz

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

Module to answer healthz checks.

1.0.0 2019-04-04 09:57 UTC

Requires

• craftcms/cms: ^3.0.0

Unknown License

• Codemonauts

• cms
• Craft
• craftcms
• craft-module

README

A really basic healthz check module for Craft CMS.

Background

If you running your Craft CMS servers behind a loadbalancer or you are monitoring your site with an external monitoring tools, you need an endpoint which

• answers early and doesn't walk through the whole stack
• answers with an 200 Ok even when a migration is waiting
• checks if the connection to the database and cache is available

Requirements

• Craft CMS >= 3.0.0

Installation

cd /path/to/project
composer require codemonauts/craft-healthz

Then add the module to the app.php in your Craft config directory like this:

<?php
return [
    // ...
    'modules' => [
        // ...
        'healthz' => codemonauts\healthz\Healthz::class,
    ],
    'bootstrap' => ['healthz'],
];

Usage

The endpoint for your monitoring system or loadbalancer is

http(s)://yoursite.com/healthz

The script answers with 200 Ok or 503 Not Ok

With ❤ by codemonauts