README

Vigilant Drupal Healthchecks

A package that adds healthchecks to any Drupal application and integrates seamlessly with Vigilant.

Installation

Install the module with Composer:

composer require govigilant/drupal-healthchecks

Enable the module via the Drupal UI or with Drush:

drush en vigilant_healthchecks -y && drush cr

Configure the bearer token and thresholds at Configuration → System → Vigilant Healthchecks once the module is enabled.

Usage

Accessing the health endpoint

After configuring a bearer token, the health payload is available at:

POST /vigilant/health

Example curl request:

curl -X POST "https://your-drupal-site.test/vigilant/health" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Available Checks

Available Metrics

Extending

You can register your own health checks or metrics by tagging services with vigilant_healthchecks.check or vigilant_healthchecks.metric.

1. Create a class that extends Vigilant\HealthChecksBase\Checks\Check (or Metric) and implement run()/measure() plus available().
2. Define the service in MODULE.services.yml and add the appropriate tag.
3. Inject any dependencies as usual; the HealthCheckRegistry automatically discovers tagged services.

services:
  my_module.check.custom_backend:
    class: Drupal\my_module\Checks\CustomBackendCheck
    arguments:
      - '@my.service'
    tags:
      - { name: vigilant_healthchecks.check }

Development Environment

A ready-to-use Docker Compose setup lives in devenv/. Start the stack: docker compose -f devenv/docker-compose.yml up --build.

This provisions Drupal 11 with MariaDB, installs this module automatically, and exposes the site on http://localhost:8000. The default admin credentials are admin / secret and the bearer token is preset to testing.

Stop everything with docker compose -f devenv/docker-compose.yml down -v when you're done.

Quality

Run the quality checks locally:

composer quality

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Vincent Boon
• All Contributors

License

The MIT License (MIT). Please see License File for more information.