Download the PHP package kalimulhaq/pulse-cronwatch without Composer
On this page you can find all versions of the php package kalimulhaq/pulse-cronwatch. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kalimulhaq/pulse-cronwatch
More information about kalimulhaq/pulse-cronwatch
Files in kalimulhaq/pulse-cronwatch
Package pulse-cronwatch
Short Description A Laravel Pulse card and recorder for monitoring scheduled commands (cron jobs): success/failure rate, last run, and duration trend over time.
License MIT
Homepage https://github.com/kalimulhaq/pulse-cronwatch
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package pulse-cronwatch
Laravel Pulse Cronwatch
Laravel Pulse Cronwatch is a Laravel Pulse card that monitors your scheduled commands (cron jobs) — every command from your scheduler, when it last ran, how often it succeeds vs fails, and when it's next due.
The card lists every task your scheduler knows about — even ones that have never fired yet — and joins them with a live record of every run captured from Laravel's scheduler events.
Capabilities at a glance:
| Column | What it shows |
|---|---|
Command |
The scheduler's display signature, normalised to the clean artisan name (closures and ->name(…) labels are preserved as-is); hover shows the full shell-wrapped form |
Cron |
The cron expression from the live schedule, e.g. 0 1 * * * |
Next due |
Human-readable countdown to the next run, hover for absolute timestamp |
Last run |
Time-ago of the most recent terminal event, or Never |
Avg |
Average successful run duration with adaptive unit (ms / s / m / h); raw ms in the cell tooltip |
Success |
Count of successful runs in the period |
Failed |
Count of failed runs in the period (highlighted red when > 0) |
Skipped |
Count of runs the scheduler skipped (overlap protection, when() callbacks, etc.) |
Requires: PHP 8.2+ · Laravel 11+ · Laravel Pulse 1.4+ · Livewire 3+
Installation
The service provider is auto-discovered by Laravel.
Register the recorder
Add the recorder class to your config/pulse.php under recorders:
There are no per-recorder options at this time — the empty [] is intentional.
Add the card to your Pulse dashboard
If you haven't already, publish Pulse's dashboard view:
Then add the card to resources/views/vendor/pulse/dashboard.blade.php wherever it fits in your grid:
The cols attribute accepts any Pulse column value (1–12 or full). rows is supported the same way other Pulse cards expose it. Pulse's period selector (1h / 6h / 24h / 7d) applies to the card automatically.
Configuration
There is no published config file for v0.x — the package uses defaults from Pulse and Laravel directly. The card's only stateful option is the active sort, which is stored in the URL via Livewire:
| URL parameter | Values | Default |
|---|---|---|
cronwatch-order-by |
next_due, failed, success, avg_duration, last_run |
next_due |
Quick start
Once installed and registered, the card needs no further setup. To see it populate quickly:
After at least one task fires, refresh /pulse — that task's row updates with its success/failed/skipped counts, last-run timestamp, and duration. All other scheduled tasks already appear in the table with cron + next due even if they haven't run yet.
Pulse Card Display
Sorting is configurable via the dropdown — defaults to next due (soonest first). Each row's hover state reveals the absolute timestamp behind the relative time strings.
Data Collection
Important: the recorder only records what actually runs. If your system cron isn't firing php artisan schedule:run every minute (or php artisan schedule:work in dev), the card will show "Never" for everything except commands you trigger manually. Verify with php artisan schedule:list to confirm Laravel sees your scheduled tasks.
Caveats
- Closure-scheduled tasks without
->name('…')collide. Two closures both default to the same"Closure"display signature, so they merge into one row in the card. Use->name('stable-name')on each scheduled closure to keep them separate. - Command rename = new row. The card's join key is the scheduler's display signature. If you rename an artisan command or change its arguments, the new signature is treated as a different row; the old signature keeps its history.
- Pulse storage trimming applies. Pulse auto-trims old entries per
pulse.storage.trim.keep(default 7 days). Cronwatch rows follow the same retention; historical data older than the trim window won't appear. - Cron / Next due require live schedule access. The card reads
app(Illuminate\Console\Scheduling\Schedule::class)->events()at render time. Web requests don't auto-bootstrap that registry, so the card resolves the Console Kernel for you — if you've heavily customised kernel bootstrapping, ensureApp\Console\Kernel::schedule()(orroutes/console.php) remains discoverable.
Changelog
Please see CHANGELOG for recent changes.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover a security issue please email [email protected] rather than using the public issue tracker.
Credits
- Kalim ul Haq
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
Support
If you find this package useful, consider supporting me on Ko-fi!
All versions of pulse-cronwatch with dependencies
illuminate/console Version ^11.0|^12.0|^13.0
illuminate/support Version ^11.0|^12.0|^13.0
laravel/pulse Version ^1.4
livewire/livewire Version ^3.0|^4.0