Download the PHP package waypointer-digital/health-laravel without Composer
On this page you can find all versions of the php package waypointer-digital/health-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download waypointer-digital/health-laravel
More information about waypointer-digital/health-laravel
Files in waypointer-digital/health-laravel
Package health-laravel
Short Description Kanbino Health endpoint for Laravel — emits stack profile + extensible probes for uptime + security advisory matching
License MIT
Homepage https://github.com/Waypointer-Digital/health-laravel
Informations about the package health-laravel
Kanbino Health (Laravel)
A drop-in /health endpoint for Laravel apps that emits:
status—healthyordegradedbased on probe outcomes (HTTP 200 / 503).checks— per-probe results (database, redis, queue, plus your own).stack— auto-collected OS profile (id/version/codename), kernel, PHP version, and dpkg package versions for a configured allowlist.
Kanbino's uptime monitor consumes the stack section to match your servers against Ubuntu Security Notices and oss-security advisories.
Install
The route GET /health is registered automatically. Override the path in config/kanbino-health.php or via KANBINO_HEALTH_PATH=/internal/health.
Response shape
Configuration
config/kanbino-health.php:
Built-in probes
| Probe | What it checks | Default | Notes |
|---|---|---|---|
DatabaseProbe |
SELECT 1 on default connection |
enabled | Reports ms |
RedisProbe |
PING on default Redis connection |
enabled | Reports ms |
QueueProbe |
Reads queue size on default connection | enabled | Reports depth (the queue backend, not the workers) |
HorizonProbe |
Active Horizon master supervisors | opt-in | Requires laravel/horizon. Catches "Redis up, but Horizon dead and jobs piling up" — different signal than QueueProbe |
DiskProbe |
Disk usage on a path | opt-in | Constructor: path, failAtPercent (default /, 95%) |
MemoryProbe |
Used memory from /proc/meminfo |
opt-in | Constructor: failAtPercent (default 95%). Returns OK with note on macOS where /proc isn't available |
CpuProbe |
Load avg vs core count | opt-in | Constructor: failAtPercent (default 150%, i.e. 1.5× core saturation). Cores read from /proc/cpuinfo, no shell_exec |
To override default thresholds or paths, bind in your AppServiceProvider:
Auth
If KANBINO_HEALTH_TOKEN is set, requests must send Authorization: Bearer <token>. The Kanbino monitor sends the configured token automatically.
Custom probes
Implement Kanbino\Health\Probes\HealthProbe and add it to the probes config array:
A failing probe flips status to degraded and the endpoint returns HTTP 503 — Kanbino's monitor will mark the service as degraded.
Stack package detection
Stack package versions are read from /var/lib/dpkg/status (Debian/Ubuntu only, no shell exec). On non-dpkg systems (macOS, Alpine), the packages block will be empty but OS/kernel/PHP detection still works where possible.
The OS is detected from /etc/os-release — ID, VERSION_ID, VERSION_CODENAME. Codename matching (noble, jammy, …) is what Kanbino uses to filter Ubuntu Security Notices for your release.
Manual usage
If you don't want the auto-registered route, set enabled => false and use HealthResponse from your own controller:
All versions of health-laravel with dependencies
illuminate/support Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/routing Version ^11.0|^12.0