PHPackages                             crontinel/laravel - 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 &amp; Monitoring](/categories/logging)
4. /
5. crontinel/laravel

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

crontinel/laravel
=================

Laravel-native cron, queue &amp; Horizon monitoring. Detects silent Horizon supervisor death, queue bottlenecks, and cron failures — things generic uptime monitors can't see.

v0.3.0(2mo ago)03MITJavaScriptPHP ^8.2|^8.3|^8.4CI passing

Since Apr 8Pushed 1mo agoCompare

[ Source](https://github.com/crontinel/laravel)[ Packagist](https://packagist.org/packages/crontinel/laravel)[ Docs](https://crontinel.com)[ RSS](/packages/crontinel-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (8)Versions (14)Used By (0)

Crontinel Laravel
=================

[](#crontinel-laravel)

[![Latest Version](https://camo.githubusercontent.com/24684bb2774ec6e720119db66943b71943b4c339623d241b9c36dfc0f03f7c60/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63726f6e74696e656c2f6c61726176656c2e737667)](https://packagist.org/packages/crontinel/laravel)[![CI](https://github.com/crontinel/laravel/actions/workflows/ci.yml/badge.svg)](https://github.com/crontinel/laravel/actions/workflows/ci.yml)[![Total Downloads](https://camo.githubusercontent.com/7e5d93842022d52a39c1f0e1fcc8a168e9e91e954c401113a24b254410144632/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63726f6e74696e656c2f6c61726176656c2e737667)](https://packagist.org/packages/crontinel/laravel)[![PHP](https://camo.githubusercontent.com/50b13d3d01778282febe11a92c7166976ae637e4ee8ffe64bce210549ed5e096/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32253230253743253230382e33253230253743253230382e342d626c7565)](https://packagist.org/packages/crontinel/laravel)[![Laravel](https://camo.githubusercontent.com/88ce7f9ac798288a91de4918224da3cf354ffc092c40118a331bb5fa3c59f968/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3131253230253743253230313225323025374325323031332d726564)](https://packagist.org/packages/crontinel/laravel)[![License](https://camo.githubusercontent.com/cea28461d50f2156f0ab30eab20b2f69781ac796f6d74030adf60a585de8ff97/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63726f6e74696e656c2f6c61726176656c2e737667)](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 crontinel/laravel
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

39

—

LowBetter than 84% of packages

Maintenance91

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

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

Every ~1 days

Total

7

Last Release

55d 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 (55 commits)")

---

Tags

laravelmonitoringqueuecronhorizoncrontinel

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/crontinel-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/crontinel-laravel/health.svg)](https://phpackages.com/packages/crontinel-laravel)
```

###  Alternatives

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.1k91.3M277](/packages/laravel-horizon)[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2362.1M4](/packages/inspector-apm-inspector-laravel)[storviaio/vantage

Vantage: Strategic queue monitoring and observability for Laravel applications.

25336.8k](/packages/storviaio-vantage)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
