Health for Laravel: Kubernetes Probes and Prometheus Metrics

Sep 22, 2026 1 view 23 stars by Paul Redmond

Health checks, Kubernetes probes, Prometheus metrics, and system monitoring for Laravel

cbox health health-check kubernetes laravel metrics monitoring prometheus

Health for Laravel

PHP Version

Health checks, Kubernetes probes, Prometheus metrics, and system monitoring for Laravel.

Quick Start

composer require cboxdk/laravel-health
php artisan vendor:publish --tag="health-config"
curl http://localhost/health

Kubernetes Probes — liveness, readiness, and startup endpoints out of the box
Prometheus Metrics — /health/metrics with health check status and system metrics
10 Built-in Checks — database, cache, queue, storage, Redis, environment, schedule, CPU, memory, disk space
System Metrics — CPU load, memory, disk, network via cboxdk/system-metrics
Container Aware — automatic cgroup detection for Docker/Kubernetes
JSON Metrics API — structured system metrics at /health/metrics/json
HTML Dashboard — optional real-time status UI
Token & IP Auth — protect endpoints with bearer tokens and IP allowlists
Response Caching — configurable TTL to reduce check overhead
Fully Extensible — implement the HealthCheck contract to add checks, or rebind RunsHealthChecks to replace the runner
Test Helpers — InteractsWithHealth and FakeHealthCheckRunner to test your endpoints without real checks
No External Assets — the dashboard ships its own CSS; nothing is loaded from a CDN

Full documentation is available in the docs/ directory. Upgrading from 2.x? Read UPGRADING.md.

composer qa        # code style, PHPStan (level max), tests, license check, audit
composer test
composer analyse
composer format

Please report vulnerabilities privately; see SECURITY.md.

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