PHPackages harunrrayhan/crontinel - 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. harunrrayhan/crontinel ActiveLibrary[Logging & Monitoring](/categories/logging) harunrrayhan/crontinel ====================== Background job and cron monitoring for Laravel. Monitors Horizon internals, queue depth, and cron health. v0.1.0(yesterday)00MITPHPPHP ^8.2|^8.3|^8.4CI failing Since Apr 6Pushed todayCompare [ Source](https://github.com/HarunRRayhan/crontinel)[ Packagist](https://packagist.org/packages/harunrrayhan/crontinel)[ RSS](/packages/harunrrayhan-crontinel/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (7)Versions (2)Used By (0) Crontinel ========= [](#crontinel) [![Latest Version](https://camo.githubusercontent.com/d8e5f6f5288823f100125d404c592bfcb6f26b87d7017a04b12f9537d25c7a28/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686172756e7272617968616e2f63726f6e74696e656c2e737667)](https://packagist.org/packages/harunrrayhan/crontinel)[![CI](https://github.com/HarunRRayhan/crontinel/actions/workflows/ci.yml/badge.svg)](https://github.com/HarunRRayhan/crontinel/actions/workflows/ci.yml)[![Total Downloads](https://camo.githubusercontent.com/1100575db4fb22ada09b091b4d7875b33ab1be2c1991247f4324da841e4d7438/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686172756e7272617968616e2f63726f6e74696e656c2e737667)](https://packagist.org/packages/harunrrayhan/crontinel)[![PHP](https://camo.githubusercontent.com/50b13d3d01778282febe11a92c7166976ae637e4ee8ffe64bce210549ed5e096/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32253230253743253230382e33253230253743253230382e342d626c7565)](https://packagist.org/packages/harunrrayhan/crontinel)[![Laravel](https://camo.githubusercontent.com/88ce7f9ac798288a91de4918224da3cf354ffc092c40118a331bb5fa3c59f968/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3131253230253743253230313225323025374325323031332d726564)](https://packagist.org/packages/harunrrayhan/crontinel)[![License](https://camo.githubusercontent.com/56d5ea39403c482f885eabc45b0e295b07970f4f131fb1679879530fb0cea32b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f486172756e5252617968616e2f63726f6e74696e656c2e737667)](LICENSE) **Background job and cron monitoring for Laravel.** Monitors Horizon internals, queue depth, and cron health — things generic monitors can't see. > Cronitor tells you a job ran. Crontinel tells you your Horizon supervisor is paused. --- What it monitors ---------------- [](#what-it-monitors) MonitorWhat it sees**Horizon**Supervisor status per supervisor (not just "Horizon is running"), paused state, failed jobs per minute**Queues**Depth per queue, failed count, oldest job age — Redis and database drivers**Cron jobs**Every scheduled command run: exit code, duration, late detection--- Requirements ------------ [](#requirements) - PHP 8.2, 8.3, or 8.4 - Laravel 11, 12, or 13 --- Installation ------------ [](#installation) ``` composer require harunrrayhan/crontinel php artisan crontinel:install ``` That's it. Visit `/crontinel` in your browser. `crontinel:install` publishes the config file and runs the migration for the `crontinel_runs` table. **Cron run tracking is automatic** — Crontinel listens to Laravel's `ScheduledTaskFinished` and `ScheduledTaskFailed` events. No wrapping or modification of your scheduled commands needed. --- CLI health check ---------------- [](#cli-health-check) ``` # Table output (human-readable) php artisan crontinel:check # JSON output (for CI/CD integration) php artisan crontinel:check --format=json # Check without firing alerts php artisan crontinel:check --no-alerts ``` Exits with code `0` when all monitors are healthy, `1` if any alert is active. Use this in CI or monitoring pipelines. --- Configuration ------------- [](#configuration) After install, edit `config/crontinel.php`: ``` return [ // Dashboard URL path (default: /crontinel) 'path' => env('CRONTINEL_PATH', 'crontinel'), // Dashboard middleware 'middleware' => ['web', 'auth'], // Connect to Crontinel SaaS for multi-app hosted dashboards (optional) 'saas_key' => env('CRONTINEL_API_KEY'), 'saas_url' => env('CRONTINEL_API_URL', 'https://app.crontinel.com'), 'horizon' => [ 'enabled' => true, 'supervisor_alert_after_seconds' => 60, 'failed_jobs_per_minute_threshold' => 5, 'connection' => 'horizon', // Redis connection name for Horizon ], 'queues' => [ 'enabled' => true, 'watch' => [], // empty = auto-discover 'depth_alert_threshold' => 1000, 'wait_time_alert_seconds' => 300, ], 'cron' => [ 'enabled' => true, 'late_alert_after_seconds' => 120, 'retain_days' => 30, ], 'alerts' => [ 'channel' => env('CRONTINEL_ALERT_CHANNEL'), // 'slack' or 'mail' 'mail' => ['to' => env('CRONTINEL_ALERT_EMAIL')], 'slack' => ['webhook_url' => env('CRONTINEL_SLACK_WEBHOOK')], ], ]; ``` ### Environment variables [](#environment-variables) ``` # Dashboard path (optional) CRONTINEL_PATH=crontinel # Alerts — set channel to 'slack' or 'mail' CRONTINEL_ALERT_CHANNEL=slack CRONTINEL_SLACK_WEBHOOK=https://hooks.slack.com/... CRONTINEL_ALERT_EMAIL=ops@yourcompany.com # SaaS reporting (optional) CRONTINEL_API_KEY=your-api-key ``` --- Alerts ------ [](#alerts) Crontinel fires alerts when: - Horizon is stopped or paused - A supervisor process goes down - Failed jobs per minute exceeds threshold - Queue depth or oldest job age exceeds threshold - A scheduled command exits with non-zero code - A scheduled command is late (missed its expected run window) Alerts **auto-resolve** and send a "resolved" notification when the issue clears. **Alert deduplication:** The same alert won't fire more than once per 5 minutes for the same issue. --- Not using Horizon? ------------------ [](#not-using-horizon) Set `horizon.enabled = false` in config. Queue and cron monitoring work independently of Horizon. --- Connecting to Crontinel SaaS ---------------------------- [](#connecting-to-crontinel-saas) The OSS package works standalone. To get multi-app hosted dashboards, longer history, and team access, visit [crontinel.com](https://crontinel.com) to join the early access list. --- License ------- [](#license) MIT — free forever. See [LICENSE](LICENSE). Built by [Harun R Rayhan](https://github.com/HarunRRayhan) · [crontinel.com](https://crontinel.com) ### Health Score 38 — LowBetter than 84% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 1d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7e06d54482377487e4780224cc416c7441c6b94112647d51afa448b3b7555272?d=identicon)[HarunRay](/maintainers/HarunRay) --- Top Contributors [![HarunRRayhan](https://avatars.githubusercontent.com/u/8705727?v=4)](https://github.com/HarunRRayhan "HarunRRayhan (30 commits)") --- Tags laravelmonitoringqueuecronhorizoncrontinel ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/harunrrayhan-crontinel/health.svg) ``` [![Health](https://phpackages.com/badges/harunrrayhan-crontinel/health.svg)](https://phpackages.com/packages/harunrrayhan-crontinel) ``` ### Alternatives [inspector-apm/inspector-laravel Code Execution Monitoring, built for developers. 2332.0M2](/packages/inspector-apm-inspector-laravel)[storviaio/vantage Vantage: Strategic queue monitoring and observability for Laravel applications. 2342.9k](/packages/storviaio-vantage) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)