Alerting Configuration Analyzer

Analyzer ID	Category	Severity	Time To Fix
alerting-config	✅ Reliability	Medium	15 minutes

What This Checks

Validates that proper alerting mechanisms are in place to detect production issues. Checks for:

• Exception notification handler (report / reportable callbacks with actual alerting)
• Log alerting channel (Slack, syslog, papertrail, Monolog custom, or alerting packages)
• Failed job notification (Queue::failing callback or job failed() methods)

Why It Matters

• Silent Failures: Without alerting, production errors go unnoticed until users complain
• Queue Health: Failed jobs without notifications silently drop critical tasks (emails, payments, etc.)
• Mean Time to Recovery: Alerting reduces MTTR from hours/days to minutes

How to Fix

Quick Fix (5 minutes)

Install a monitoring package — these auto-register exception handlers and satisfy the check without any extra configuration:

composer require sentry/sentry-laravel
# or
composer require rollbar/rollbar-laravel
# or
composer require bugsnag/bugsnag-laravel

Alternatively, add a Slack log channel for immediate alerts:

// config/logging.php
'channels' => [
    'slack' => [
        'driver' => 'slack',
        'url' => env('LOG_SLACK_WEBHOOK_URL'),
        'username' => 'Laravel Bot',
        'emoji' => ':boom:',
        'level' => 'error',
    ],
    'stack' => [
        'driver' => 'stack',
        'channels' => ['daily', 'slack'],
    ],
],

Proper Fix (15 minutes)

1. Add exception alerting:

Laravel 11+ (bootstrap/app.php)

->withExceptions(function (Exceptions $exceptions) {
    $exceptions->reportable(function (Throwable $e) {
        if (app()->environment('production')) {
            Notification::route('slack', config('services.slack.webhook'))
                ->notify(new ExceptionOccurred($e));
        }
    });
})

Laravel 9-10 (Handler.php)

public function register(): void
{
    $this->reportable(function (Throwable $e) {
        if (app()->environment('production')) {
            Notification::route('slack', config('services.slack.webhook'))
                ->notify(new ExceptionOccurred($e));
        }
    });
}

2. Add failed job notifications:

// app/Providers/AppServiceProvider.php
use Illuminate\Support\Facades\Queue;
use Illuminate\Queue\Events\JobFailed;

public function boot(): void
{
    Queue::failing(function (JobFailed $event) {
        Log::channel('slack')->error('Job failed', [
            'job' => $event->job->resolveName(),
            'exception' => $event->exception->getMessage(),
        ]);
    });
}

References

• Laravel Error Handling
• Laravel Notifications
• Laravel Queue Failed Jobs

Related Analyzers

• Missing Error Tracking - Detects missing error tracking services
• Health Check - Validates health check endpoints
• Data Retention Policy - Validates data cleanup policies