PHPackages                             actinity/laravel-queue-status - 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. [Queues & Workers](/categories/queues)
4. /
5. actinity/laravel-queue-status

ActiveLibrary[Queues & Workers](/categories/queues)

actinity/laravel-queue-status
=============================

Queue Status Monitor

3.4.2(1y ago)139.7k↓72.7%PHP

Since May 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Actinity/queue-status-monitor)[ Packagist](https://packagist.org/packages/actinity/laravel-queue-status)[ RSS](/packages/actinity-laravel-queue-status/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependencies (3)Versions (19)Used By (0)

Laravel Queue Status Monitor
============================

[](#laravel-queue-status-monitor)

Once installed this will add itself to the schedule and dispatch a job every minute on the `default` queue which updates a cached value.

The `/queue-status-monitor` endpoint shows the status of the monitor and will return either 200 OK or 400 if queues have not run within the expected threshold (5 minutes by default. This endpoint can then be monitored by Pingdom or similar.

If you are using multiple queues, or if you wish to customise thresholds you can add a `monitor` array to `config/queue.php`. Examples are:

### Monitor a single queue

[](#monitor-a-single-queue)

```
    "monitor" => "myqueue"

```

### Monitor multiple queues

[](#monitor-multiple-queues)

```
    "monitor" => [
        "myqueue",
        "myotherqueue"
    ]

```

### Monitor a queue with a custom threshold

[](#monitor-a-queue-with-a-custom-threshold)

```
    "monitor" => [
        ["name" => myqueue","threshold" => 600],
    ]

```

Threshold values are specified in seconds and represent the point where the monitor will report that the queue is failing if the job has not run within that period.

Delay
-----

[](#delay)

As well as reporting the last run time, the `/queue-status-monitor`endpoint also reports the `delay`. This is the time between the job being dispatched and handled. This does not impact the overall status and will not trigger failures. It is purely for reference.

Failed Jobs
-----------

[](#failed-jobs)

By default, if you have a failed\_jobs table, then any failures will be treated as errors and generate a 400 status code. You can disable this by adding the following to `config/queue.php`.

`"do_not_monitor_failed_jobs" => true`

Alternatively, if you are prepared to tolerate failed jobs, but don't want them to stop you knowing if there is another issue; you can monitor independent endpoints rather than just the default:

`queue-status-monitor/without-failed` will ignore failed jobs and only report on thresholds and misconfiguration.

`queue-status-monitor/only-failed` will only check failed jobs.

Timeout vs retry\_after misconfiguration checks
-----------------------------------------------

[](#timeout-vs-retry_after-misconfiguration-checks)

Queue workers are typically configured via Supervisor or similar, and the `queue:work` command includes a `--timeout` property. If this is set higher than the corresponding `retry_after` property (in `config.queue`) it can cause jobs to be duplicated. The monitor checks for this and will alert in the endpoint (and throw a 400 response).

Last dispatch
-------------

[](#last-dispatch)

The `Last dispatch` value at the top of the queue monitor indicates the last time the `queue-status:ping` command was dispatched by the scheduler (typically every minute if you're using standard Laravel cron configuration). This doesn't trigger any errors by itself, but is shown for reference to help debug if the issue is with your crontab.

Auth
----

[](#auth)

If you want to protect your monitor endpoints, add:

`"status_password" => "YOURPASSWORD"`

To the queue config. The default username is 'queues', but you can customise this as well by setting:

`"status_user" => "USERNAME"`

Disable in certain environments
-------------------------------

[](#disable-in-certain-environments)

You can disable the queue monitor by adding

`"status_monitor_disabled" => env("QUEUE_MONITOR_DISABLED",false)`

in your queue config, and then setting that value to true in your `.env` file.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance46

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity65

Established project with proven stability

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

Recently: every ~171 days

Total

18

Last Release

416d ago

Major Versions

1.3 → 2.02022-01-13

2.0 → 3.02022-04-03

### Community

Maintainers

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

---

Top Contributors

[![Actinity](https://avatars.githubusercontent.com/u/1878605?v=4)](https://github.com/Actinity "Actinity (34 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/actinity-laravel-queue-status/health.svg)

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

###  Alternatives

[league/geotools

Geo-related tools PHP 7.3+ library

1.4k5.6M31](/packages/league-geotools)[illuminate/bus

The Illuminate Bus package.

6046.3M542](/packages/illuminate-bus)[uecode/qpush-bundle

Asynchronous processing for Symfony using Push Queues

1672.5M2](/packages/uecode-qpush-bundle)[belvg/module-sqs

N/A

1544.6k](/packages/belvg-module-sqs)[bsidev/bitrix-queue

Queues for Bitrix CMS

232.8k](/packages/bsidev-bitrix-queue)[mayconbordin/l5-stomp-queue

Stomp Queue Driver for Laravel 5

121.1k](/packages/mayconbordin-l5-stomp-queue)

PHPackages © 2026

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