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(4mo ago)00MITPHPPHP ^8.2

Since Apr 3Pushed 4mo 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 1w ago

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

34

—

LowBetter than 74% of packages

Maintenance75

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

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

137d 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.2k99.8M355](/packages/laravel-horizon)[spatie/laravel-health

Monitor the health of a Laravel application

88212.7M188](/packages/spatie-laravel-health)[anousss007/vigilance

A driver-agnostic control center for Laravel queues, jobs, commands and the scheduler. Monitor what ran (with parameters), see failures, and dispatch jobs or run artisan commands manually from a self-contained dashboard.

1939.9k](/packages/anousss007-vigilance)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9922.4M146](/packages/roots-acorn)[yangusik/laravel-balanced-queue

Laravel queue management with load balancing between partitions (user groups)

8516.9k](/packages/yangusik-laravel-balanced-queue)[simplestats-io/laravel-client

Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof.

5226.7k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

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