PHPackages                             getecz/laravel-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. [Logging & Monitoring](/categories/logging)
4. /
5. getecz/laravel-health

ActiveLibrary[Logging & Monitoring](/categories/logging)

getecz/laravel-health
=====================

Laravel-native app health checks (DB/cache/queue/storage/cron) with dashboard + JSON endpoints.

v1.0.0(4mo ago)27120—0%3MITPHPPHP ^8.1

Since Dec 15Pushed 3mo agoCompare

[ Source](https://github.com/ajithjojo/getecz-laravel-health)[ Packagist](https://packagist.org/packages/getecz/laravel-health)[ RSS](/packages/getecz-laravel-health/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Getecz Laravel Health
=====================

[](#getecz-laravel-health)

Laravel-native app health checks (DB / cache / storage / queue / cron) with a simple dashboard and JSON endpoint.

- ✅ No build step
- ✅ Tailwind CDN UI
- ✅ Works great for shared hosting + small VPS
- ✅ Optional token + IP allowlist

---

[![](https://camo.githubusercontent.com/44afd4b504498a9a79ae0c2345ddc5ef469c2b7d96facbe1dc58c85b2af62cc8/68747470733a2f2f692e706f7374696d672e63632f4c386d3467634a572f53637265656e73686f742d323032352d31322d31352d3139323930352e706e67)](https://camo.githubusercontent.com/44afd4b504498a9a79ae0c2345ddc5ef469c2b7d96facbe1dc58c85b2af62cc8/68747470733a2f2f692e706f7374696d672e63632f4c386d3467634a572f53637265656e73686f742d323032352d31322d31352d3139323930352e706e67)

Install
-------

[](#install)

```
composer require getecz/laravel-health
```

Laravel auto-discovers the service provider.

---

Usage
-----

[](#usage)

After install, open:

- Dashboard: `/` (default: `/getecz-health`)
- JSON: `//json` (default: `/getecz-health/json`)
- Widget (iframe): `//widget` (default: `/getecz-health/widget`)
- Cron heartbeat: `//heartbeat` (default: `/getecz-health/heartbeat`)

---

Security (Never Miss)
---------------------

[](#security-never-miss)

In production, you **must** lock it down.

### Option A — Token (recommended)

[](#option-a--token-recommended)

Set an env token:

```
GETECZ_HEALTH_TOKEN=your-long-random-token
```

Then access with:

- Query: `/getecz-health?token=your-long-random-token`
- Header: `X-Getecz-Health-Token: your-long-random-token`

### Option B — IP allowlist

[](#option-b--ip-allowlist)

```
GETECZ_HEALTH_ALLOWED_IPS=1.2.3.4,5.6.7.8
```

### Disable completely

[](#disable-completely)

```
GETECZ_HEALTH_ENABLED=false
```

---

Publish config (optional)
-------------------------

[](#publish-config-optional)

```
php artisan vendor:publish --tag=getecz-health-config
```

Config file: `config/getecz-health.php`

---

Cron heartbeat
--------------

[](#cron-heartbeat)

The Cron check is **based on a heartbeat**. You have two ways:

### 1) Hit the heartbeat URL (shared hosting friendly)

[](#1-hit-the-heartbeat-url-shared-hosting-friendly)

Set a cron (or external monitor) to hit:

`/getecz-health/heartbeat?token=...`

### 2) Run the artisan heartbeat command

[](#2-run-the-artisan-heartbeat-command)

```
php artisan getecz:health-heartbeat
```

Then schedule it:

```
// app/Console/Kernel.php
$schedule->command('getecz:health-heartbeat')->everyMinute();
```

---

Store history (optional)
------------------------

[](#store-history-optional)

If you want snapshots in DB:

1. Publish migrations

```
php artisan vendor:publish --tag=getecz-health-migrations
php artisan migrate
```

2. Enable history

```
GETECZ_HEALTH_STORE_HISTORY=true
```

3. Create snapshots via command (recommended)

```
php artisan getecz:health-snapshot
php artisan getecz:health-snapshot --prune
```

---

Embed widget
------------

[](#embed-widget)

You can embed the widget in any dashboard via iframe:

```

```

Or fetch JSON:

`/getecz-health/json?token=YOUR_TOKEN`

---

Custom checks
-------------

[](#custom-checks)

Publish config and add your own check class to the `checks` array.

A check must implement:

`Getecz\LaravelHealth\Checks\CheckInterface`

---

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance77

Regular maintenance activity

Popularity24

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

148d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4ac3ae914aadbc6c1e9760a9ba8ce150a3aefe238ad9c9ea3fe0d9f8e60c14a?d=identicon)[getecz](/maintainers/getecz)

---

Top Contributors

[![ajithjojo](https://avatars.githubusercontent.com/u/7994484?v=4)](https://github.com/ajithjojo "ajithjojo (6 commits)")[![erkiaas](https://avatars.githubusercontent.com/u/25956365?v=4)](https://github.com/erkiaas "erkiaas (1 commits)")

---

Tags

laravelmonitoringhealthperformanceops

### Embed Badge

![Health badge](/badges/getecz-laravel-health/health.svg)

```
[![Health](https://phpackages.com/badges/getecz-laravel-health/health.svg)](https://phpackages.com/packages/getecz-laravel-health)
```

###  Alternatives

[jackwh/laravel-new-relic

Monitor your Laravel application performance with New Relic

112827.2k](/packages/jackwh-laravel-new-relic)[scoutapp/scout-apm-laravel

Scout Application Performance Monitoring Agent - https://scoutapm.com

23831.3k](/packages/scoutapp-scout-apm-laravel)[tobiasdierich/gauge

An easy to use application performance monitor.

14413.1k](/packages/tobiasdierich-gauge)[kitloong/laravel-app-logger

Laravel log for your application

101.2M8](/packages/kitloong-laravel-app-logger)[kssadi/log-tracker

A powerful, intuitive, and efficient log viewer for Laravel applications.

264.8k](/packages/kssadi-log-tracker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)