PHPackages                             perfectwebteam/craft-ohdear-application-health - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. perfectwebteam/craft-ohdear-application-health

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

perfectwebteam/craft-ohdear-application-health
==============================================

Oh Dear Application Health checker for Craft CMS.

1.2.0(7mo ago)0644↓50%MITPHPPHP ^8.0.2

Since May 6Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/perfectwebteam/craft-ohdear-application-health)[ Packagist](https://packagist.org/packages/perfectwebteam/craft-ohdear-application-health)[ RSS](/packages/perfectwebteam-craft-ohdear-application-health/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (2)Versions (9)Used By (0)

[![Oh Dear Application Health checker icon](./src/icon.svg)](./src/icon.svg)

Oh Dear Application Health checker for Craft CMS
================================================

[](#oh-dear-application-health-checker-for-craft-cms)

This plugin provides an [Oh Dear](https://ohdear.app) Application Health checker for [Craft CMS](https://craftcms.com/).

🚦 Health Checks Overview
------------------------

[](#-health-checks-overview)

This plugin performs the following health checks and provides a JSON feed at `/application-health.json` for Oh Dear.

The response is cached for 5 minutes.

### ✅ Updates

[](#-updates)

Checks if updates are available for Craft CMS and installed plugins, including critical ones.

### ✅ Queue Status

[](#-queue-status)

Monitors the number of jobs in the queue and detects failed, reserved, or delayed jobs using configurable thresholds.

### ✅ Pending Migrations

[](#-pending-migrations)

Verifies if there are any unapplied database migrations.

### ✅ Error Logs

[](#-error-logs)

Counts recent errors in today’s log files (`web.log`, `queue.log`, `console.log`).

### ✅ Git Repository Status

[](#-git-repository-status)

Checks if a `.git` repository exists and whether there are uncommitted changes.

### ✅ Security Headers

[](#-security-headers)

Fetches site headers and verifies the presence of key security headers (e.g., CSP, HSTS, X-Frame-Options).

### ✅ Project Config Status

[](#-project-config-status)

Confirms if the project configuration is fully synchronized.

### ✅ PHP Version

[](#-php-version)

Reports the active PHP version running on the server and verifies it against a minimum required version.

### ✅ Admin Users

[](#-admin-users)

Lists all admin users and flags users who haven’t logged in for a configurable period.

### ✅ Disk Usage

[](#-disk-usage)

Monitors disk space usage and flags if usage exceeds a configurable threshold.
*(Disabled by default to avoid noise on shared servers.)*

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.0.0+ or 5.0.0+.

Installation
------------

[](#installation)

You can install this plugin from the Plugin Store or with Composer.

#### From the Plugin Store

[](#from-the-plugin-store)

Go to the Plugin Store in your project’s Control Panel and search for “Oh Dear Application Health”. Then click on the “Install” button in its modal window.

#### With Composer

[](#with-composer)

Open your terminal and run the following commands:

```
# Go to the project directory
cd /path/to/my-project.test

# Tell Composer to load the plugin
composer require perfectwebteam/craft-ohdear-application-health

# Tell Craft to install the plugin
./craft plugin/install ohdear-application-health
```

Setup
-----

[](#setup)

Once Oh Dear Application Health is installed:

1. Go to your site in **Oh Dear** and activate the **Application health** check.
2. Set the **Health Report URL** to `https://www.yourdomain.com/application-health.json`.
3. Copy the **Health Report Secret** value and set it as value for `OH_DEAR_HEALTH_REPORT_SECRET=` in your `.env` file.
4. Optionally add a `config/ohdear-application-health.php` configuration file in which you can override the default settings.

Example configuration:

```