PHPackages                             aryeo/monitored-jobs - 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. aryeo/monitored-jobs

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

aryeo/monitored-jobs
====================

Monitor for your Laravel jobs.

v5.0.0(9mo ago)1325.8k↓50%31MITPHPPHP ^8.2CI failing

Since Dec 14Pushed 9mo ago3 watchersCompare

[ Source](https://github.com/AryeoHQ/monitored-jobs)[ Packagist](https://packagist.org/packages/aryeo/monitored-jobs)[ Docs](https://github.com/AryeoHQ/monitored-jobs)[ RSS](/packages/aryeo-monitored-jobs/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (16)Used By (1)

Monitored Jobs for Laravel
==========================

[](#monitored-jobs-for-laravel)

Overview
--------

[](#overview)

This package tracks the status and history of your queued jobs by hooking into the events that Laravel fires for its queue system.

We store this data in a database table, `monitored_jobs`.

Installation
------------

[](#installation)

`composer require aryeo/monitored-jobs`

Configuration
-------------

[](#configuration)

You can optionally publish the configuration file, which allows you to configure:

- if monitoring is enabled
- which jobs to monitor
- the number of days to keep monitored job history before pruning

To publish the config file:

`php artisan vendor:publish --tag=monitored-jobs`

### Controlling monitoring

[](#controlling-monitoring)

To control whether *any* job is monitored, set the `monitored-jobs.enabled` configuration value.

There are two configuration options for filtering which jobs are monitored: `include_jobs` and `exclude_jobs`. The default value for both config options is `null`, which will include any job class.

- `'include_jobs' => null` means we are not setting the config option, so all jobs are monitored
- `'include_jobs' => []` means we are setting the config option to include no jobs, meaning no jobs are monitored

#### Including and excluding the same job class

[](#including-and-excluding-the-same-job-class)

The `exclude_jobs` option will be checked first and will skip monitoring the job if it is found to be excluded.

### Pruning Monitored Jobs

[](#pruning-monitored-jobs)

The `MonitoredJob` model is setup to use Laravel's model pruning: .

In order for the models to be pruned, you must setup the command via the scheduler:

```
protected function schedule(Schedule $schedule)
{
    $schedule->command('model:prune')->daily();
}

```

You can adjust how long the monitored job records are kept for via the config file:

```
'prune_after_days' => 14,

```

Tags
----

[](#tags)

The package will attempt to pull tags off of job classes. It does this by either using the `tags` method on the job class, or by pulling the arguments off of the job's constructor. When pulling the arguments off the constructor:

- Models &amp; collections of models will be serialized as `{$class}_{$KEY}`
- Arrays will be JSON encoded
- Booleans will be converted to "true" / "false" strings
- Strings and numbers will be stored as-is
- Objects will not be stored as tags

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance58

Moderate activity, may be stable

Popularity35

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~111 days

Recently: every ~230 days

Total

13

Last Release

276d ago

Major Versions

v1.0.2 → v2.0.02022-03-23

v2.0.5 → v3.0.02024-02-28

v3.0.1 → v4.0.02025-01-23

v4.0.0 → v5.0.02025-08-15

PHP version history (3 changes)v1.0.0PHP &gt;=8.0

v3.0.1PHP ^8.1

v4.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/c753ed243e6ca82419d8364d26a9f3143f7d90a6c50c8a677f9a5db48beb21f3?d=identicon)[aryeo](/maintainers/aryeo)

---

Top Contributors

[![owenconti](https://avatars.githubusercontent.com/u/791222?v=4)](https://github.com/owenconti "owenconti (8 commits)")[![therobfonz](https://avatars.githubusercontent.com/u/35386780?v=4)](https://github.com/therobfonz "therobfonz (7 commits)")[![speercy](https://avatars.githubusercontent.com/u/2145450?v=4)](https://github.com/speercy "speercy (3 commits)")[![jamespavett](https://avatars.githubusercontent.com/u/10764464?v=4)](https://github.com/jamespavett "jamespavett (1 commits)")

---

Tags

laravelmonitoringqueuelaravelqueuejobsmonitoraryeo

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/aryeo-monitored-jobs/health.svg)

```
[![Health](https://phpackages.com/badges/aryeo-monitored-jobs/health.svg)](https://phpackages.com/packages/aryeo-monitored-jobs)
```

###  Alternatives

[harris21/laravel-fuse

Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures.

3786.5k](/packages/harris21-laravel-fuse)[rigor789/airbrake-laravel

Laravel package for the Airbrake API, which supports Errbit

1636.5k](/packages/rigor789-airbrake-laravel)

PHPackages © 2026

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