v2.0.0

Changed

• Breaking: Bump cboxdk/system-metrics dependency from ^2.1 to ^3.0. CPU core values (core_count, host_cpu_cores, cores) are now float instead of int, supporting fractional CPU allocations in containerized environments (e.g. 0.5 cores).

v1.0.1

Fixed

• Use environment->containerization->insideContainer for the containerized flag in system metrics instead of SystemLimits::isContainerized(). The cgroup source alone is unreliable on modern Linux where cgroup v2 is default even on VMs.

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Laravel Health v1.0.0

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

Features

• Kubernetes Probes — liveness, readiness, and startup endpoints
• 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 v1/v2 detection for Docker/Kubernetes
• CIDR IP Auth — token auth, IP allowlists with CIDR range support, custom auth callbacks
• Artisan Commands — health:check for CLI verification, health:heartbeat for scheduler monitoring
• Response Caching — configurable TTL to reduce check overhead
• HTML Dashboard — optional real-time status UI
• Fully Extensible — implement HealthCheck contract to add custom checks

Requirements

• PHP 8.3+
• Laravel 11.x, 12.x, or 13.x

Quick Start

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

Links

• Documentation
• CHANGELOG