PHPackages                             hostatlas/queue-monitor - 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 & Monitoring](/categories/logging)
4. /
5. hostatlas/queue-monitor

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

hostatlas/queue-monitor
=======================

Push Laravel queue metrics to HostAtlas for monitoring, alerting, and visualization.

v1.0.1(3mo ago)00MITPHPPHP ^8.2

Since Apr 3Pushed 3mo agoCompare

[ Source](https://github.com/akyroslabs/hostatlas-queue-monitor)[ Packagist](https://packagist.org/packages/hostatlas/queue-monitor)[ RSS](/packages/hostatlas-queue-monitor/feed)WikiDiscussions main Synced today

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

HostAtlas Queue Monitor
=======================

[](#hostatlas-queue-monitor)

Push Laravel queue metrics to [HostAtlas](https://hostatlas.app) for real-time monitoring, alerting, and visualization.

HostAtlas is an infrastructure visibility platform with 340+ features — server monitoring, uptime checks, incident management, attack defense, AI analysis, and more. The Queue Monitor package connects your Laravel queues to the HostAtlas dashboard, so you can track queue health alongside the rest of your infrastructure.

**[Sign up free](https://my.hostatlas.app/register)** — no credit card required.

---

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11 or 12
- A HostAtlas account with an API key

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

[](#installation)

```
composer require hostatlas/queue-monitor
```

The service provider is auto-discovered. No manual registration needed.

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

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag=hostatlas-queue-config
```

Add to your `.env`:

```
HOSTATLAS_URL=https://my.hostatlas.app
HOSTATLAS_API_KEY=ha_your_api_key_here
HOSTATLAS_SERVER=web-prod-01
```

VariableDescriptionDefault`HOSTATLAS_URL`Your HostAtlas instance URL`https://my.hostatlas.app``HOSTATLAS_API_KEY`API key from HostAtlas (Settings > API Keys)—`HOSTATLAS_SERVER`Server hostname (must match a server in HostAtlas)System hostname### Queue Selection

[](#queue-selection)

By default, all queues are auto-detected. To monitor specific queues only, edit `config/hostatlas-queue.php`:

```
'queues' => ['default', 'emails', 'notifications'],
```

Use `['*']` to auto-detect all queues (default).

Usage
-----

[](#usage)

### Via Scheduler (recommended)

[](#via-scheduler-recommended)

Add to your `routes/console.php`:

```
Schedule::command('hostatlas:queue-metrics')->everyMinute();
```

### Manual

[](#manual)

```
php artisan hostatlas:queue-metrics
```

Example output:

```
  default: 42 pending, 2 failed
  emails: 8 pending, 0 failed
  Queue metrics reported to HostAtlas.

```

Supported Queue Drivers
-----------------------

[](#supported-queue-drivers)

DriverAuto-detect QueuesMetrics**Redis**Yes (scans Redis keys)Size, failed, system type**Database**Yes (groups by queue column)Size, failed, processing count**SQS**No (uses configured queue)SizeWhat Gets Reported
------------------

[](#what-gets-reported)

Each queue reports:

- **Queue name** — auto-detected or configured
- **Pending jobs** — current queue size
- **Failed jobs** — count from `failed_jobs` table
- **Processing jobs** — currently being processed (database driver)
- **System type** — `laravel` (auto-set)

API Push Endpoint
-----------------

[](#api-push-endpoint)

The package pushes to `POST {HOSTATLAS_URL}/api/v1/queue/push` with Bearer token authentication. You can also push metrics from any language or framework using the same endpoint:

```
curl -X POST https://my.hostatlas.app/api/v1/queue/push \
  -H "Authorization: Bearer ha_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "web-prod-01",
    "queues": [
      {"name": "default", "size": 42, "failed": 2, "processing": 3, "system": "laravel"}
    ]
  }'
```

Multi-System Support
--------------------

[](#multi-system-support)

The HostAtlas queue dashboard supports metrics from multiple systems:

- **Laravel** (this package)
- **BullMQ** (Node.js — via API push)
- **Sidekiq** (Ruby — via API push)
- **Celery** (Python — via API push)

Security
--------

[](#security)

- API key is transmitted via `Authorization: Bearer` header over HTTPS
- No sensitive data is collected — only queue names and counts
- 10-second HTTP timeout per request
- Errors are reported via Laravel's `report()` helper (logged, never thrown)

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

---

Built by [Akyros Labs LLC](https://akyroslabs.com) —

[HostAtlas](https://hostatlas.app) | [Documentation](https://hostatlas.app/tools/queue-monitor) | [Sign up free](https://my.hostatlas.app/register)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance82

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Total

2

Last Release

92d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2a92905b10878a7760ef1c7e23d505308880336d99c2b247fe4759c4d31185ca?d=identicon)[AkyrosLabs](/maintainers/AkyrosLabs)

---

Top Contributors

[![akyroslabs](https://avatars.githubusercontent.com/u/257565678?v=4)](https://github.com/akyroslabs "akyroslabs (1 commits)")

---

Tags

laravelmonitoringredisqueuehorizonhostatlas

### Embed Badge

![Health badge](/badges/hostatlas-queue-monitor/health.svg)

```
[![Health](https://phpackages.com/badges/hostatlas-queue-monitor/health.svg)](https://phpackages.com/packages/hostatlas-queue-monitor)
```

###  Alternatives

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M307](/packages/laravel-horizon)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M165](/packages/spatie-laravel-health)[storviaio/vantage

Vantage: Strategic queue monitoring and observability for Laravel applications.

25769.2k](/packages/storviaio-vantage)

PHPackages © 2026

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