Looking to hire Laravel developers? Try LaraJobs

laravel-swarm-pulse maintained by builtbyberry

Description
Laravel Pulse integration for Laravel Swarm — recorders and dashboard cards for swarm runs, steps, memory, and audit outbox observability.
Author
Last update
2026/07/06 12:35 (dev-main)
License
Downloads
0

Comments
comments powered by Disqus

Laravel Swarm Pulse

Laravel Pulse integration for Laravel Swarm — recorders and dashboard cards for swarm runs, step durations, memory growth, and audit outbox observability.

This package was extracted from builtbyberry/laravel-swarm core in v0.17.0 to keep the core package's dependency footprint small. If you were using Pulse recorders or cards from laravel-swarm before v0.17.0, install this package and update your imports — see UPGRADING.md in core for the migration steps.

Installation

composer require builtbyberry/laravel-swarm-pulse

Then, once Pulse itself is installed and published:

composer require laravel/pulse

php artisan vendor:publish --provider="Laravel\Pulse\PulseServiceProvider"

php artisan migrate

php artisan swarm:install:pulse

swarm:install:pulse registers the SwarmRuns, SwarmStepDurations, and SwarmMemoryMetrics recorders in config/pulse.php and injects the swarm cards into resources/views/vendor/pulse/dashboard.blade.php. Both edits are sentinel-fenced and safe to re-run; the original files are backed up to <file>.bak before the first mutation.

Pick which cards to enable with --cards (default: all four):

php artisan swarm:install:pulse --no-interaction --cards=runs,steps

If Pulse is not installed, the command refuses with a copy-paste hint and exits non-zero.

Cards

Card Livewire tag What it shows
Swarm Runs <livewire:swarm.runs /> Per-swarm totals, failures, failure rate, average run duration, topology mix
Swarm Steps <livewire:swarm.steps /> Slowest average step durations by swarm + agent
Swarm Audit Outbox <livewire:swarm.audit-outbox /> Live operational state of the audit outbox (pending, dead-letter, stale)
Swarm Memory <livewire:swarm.memory /> Memory growth + snapshot size per scope

See core's docs/pulse.md for the full aggregate-type reference, tuning knobs, and troubleshooting guide — this package's behavior is unchanged from the pre-extraction integration, only the namespace and package boundary moved.

License

MIT.