README

Enhanced CLI

Installation

composer require queuewatch/laravel

Basic Commands

# List all failed jobs (table format)
php artisan queue:failed

# Output as JSON
php artisan queue:failed --json

Filtering Options

# Filter by queue name
php artisan queue:failed --queue=emails

# Filter by connection
php artisan queue:failed --connection=redis

# Filter by date range
php artisan queue:failed --after="2025-11-20"
php artisan queue:failed --before="2025-11-21"
php artisan queue:failed --after=yesterday --before=today

# Filter by job class (partial match)
php artisan queue:failed --class=SendEmail

# Limit results
php artisan queue:failed --limit=50

# Combine multiple filters
php artisan queue:failed --queue=emails --after=yesterday --limit=10 --json

JSON Output Format

{
  "failed_jobs": [
    {
      "id": "1234",
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "connection": "redis",
      "queue": "emails",
      "payload": {
        "displayName": "App\\Jobs\\SendEmail",
        "job": "Illuminate\\Queue\\CallQueuedHandler@call",
        "data": {}
      },
      "exception": "Connection timeout...",
      "failed_at": "2025-11-21 10:30:00"
    }
  ],
  "count": 1
}

Queuewatch.io (Optional)

Official Laravel package for Queuewatch - Real-time queue failure monitoring with instant notifications.

• Real-time Failure Reporting - Automatically capture and report queue job failures to your Queuewatch dashboard
• Rich Exception Data - Full stack traces, job payloads, and server context
• Smart Filtering - Ignore specific jobs, queues, or exception types
• Remote Retry - Retry failed jobs directly from the Queuewatch dashboard
• Instant Notifications - Get notified via Slack, Discord, email, or webhooks when jobs fail

Requirements

• PHP 8.1+
• Laravel 10.x, 11.x, or 12.x
• A Queuewatch account

Installation

composer require queuewatch/laravel

Add your API key to .env:

QUEUEWATCH_API_KEY=qw_live_xxxxxxxxxxxxxxxxxxxx

That's it! The package automatically hooks into Laravel's queue system and starts reporting failures.

Getting Your API Key

1. Sign up at queuewatch.io
2. Create a new project in your dashboard
3. Copy the API key from Settings → API Keys
4. Add it to your .env file

Configuration

Publish the config file for advanced customization:

php artisan vendor:publish --tag=queuewatch-config

Available Options

// config/queuewatch.php
return [
    'enabled' => env('QUEUEWATCH_ENABLED', true),
    'api_key' => env('QUEUEWATCH_API_KEY'),
    'project' => env('QUEUEWATCH_PROJECT', env('APP_NAME')),
    'environment' => env('QUEUEWATCH_ENVIRONMENT', env('APP_ENV')),

    // Jobs to ignore
    'ignored_jobs' => [
        // App\Jobs\NoisyJob::class,
    ],

    // Queues to ignore
    'ignored_queues' => [
        // 'low-priority',
    ],

    // Exceptions to ignore
    'ignored_exceptions' => [
        // Illuminate\Database\Eloquent\ModelNotFoundException::class,
    ],
];

Environment Variables

Testing Your Integration

php artisan queuewatch:test

This verifies your API key and connection. Add --send-test to send a test failure:

php artisan queuewatch:test --send-test

You should see the test failure appear in your Queuewatch dashboard within seconds.

What Gets Reported

When a job fails, Queuewatch captures:

• Job Details - Class name, queue, connection, attempts, max tries
• Exception - Message, class, file, line, full stack trace
• Payload - Complete job payload (can be disabled for sensitive data)
• Context - Server hostname, PHP version, Laravel version, timestamp
• Environment - Your configured environment label

Remote Retry

Enable remote retry to retry failed jobs directly from the Queuewatch dashboard:

QUEUEWATCH_RETRY_ENABLED=true

Configure allowed queues for security:

'retry' => [
    'enabled' => env('QUEUEWATCH_RETRY_ENABLED', false),
    'allowed_queues' => ['payments', 'emails'], // or ['*'] for all
],

When enabled, you can click "Retry" on any failed job in your Queuewatch dashboard, and it will be re-dispatched to your Laravel application.

Notifications

Configure notifications in your Queuewatch dashboard:

• Slack - Get alerts in your team's Slack channel
• Discord - Send notifications to Discord webhooks
• Email - Receive email alerts for failures
• Webhooks - Integrate with any service via custom webhooks

Set up notification rules to filter by environment, job type, or failure frequency.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Marian Pop
• All Contributors

License

The MIT License (MIT). Please see License File for more information.