Skip to content

v1.0.0

Choose a tag to compare

@sylvesterdamgaard sylvesterdamgaard released this 20 Mar 22:17

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 Commandshealth: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