Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/codemonauts/craft-healthz

Craft CMS module to answer healthz checks
https://github.com/codemonauts/craft-healthz

cms craft craftcms healthz plugin

Last synced: about 4 hours ago
JSON representation

Craft CMS module to answer healthz checks

Awesome Lists containing this project

README

        

# Healthz module for Craft CMS 3.x

![Icon](resources/healthz.png)

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

```shell
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
[
// ...
'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](https://codemonauts.com)