README

Send Laravel application error alerts directly to Google Chat using Incoming Webhooks.

This package integrates with Laravel's logging system and sends log events to a Google Chat space.

Supports Laravel 8, 9, 10, 11 and 12.

🚀 Features

Google Chat webhook integration
Custom Monolog logging driver
Supports Laravel 8--12
Environment-based log level filtering
Auto-discovery support
Works with HTTP & CLI errors
Compatible with Monolog 2 & 3
Plug & Play configuration

📦 Installation

Install via Composer:

composer require savan/gchat-error-alert

🔧 Step 1: Create Google Chat Webhook

Open Google Chat
Go to the Space where you want alerts
Click Space name → Manage Webhooks
Click Add Webhook
Copy the generated Webhook URL

Example webhook:

https://chat.googleapis.com/v1/spaces/XXXX/messages?key=XXX&token=XXX

⚙ Step 2: Publish Configuration

Run:

php artisan vendor:publish --tag=gchat-alert-config

This will create:

config/gchat-alert.php

🧾 Step 3: Configure Environment Variables

Add to your .env file:

GCHAT_ALERT_ENABLED=true
GCHAT_ALERT_WEBHOOK=https://chat.googleapis.com/v1/spaces/XXXX/messages?key=XXX&token=XXX
GCHAT_ALERT_LEVEL=error

📝 Step 4: Configure Logging

Open:

config/logging.php

Add this channel inside channels:

'gchat' => [
    'driver' => 'gchat',
],

Then add it to your stack:

'stack' => [
    'driver' => 'stack',
    'channels' => ['daily', 'gchat'],
],

Make sure your default log channel is:

LOG_CHANNEL=stack

🔥 Step 5: Clear Configuration Cache

php artisan config:clear
php artisan cache:clear

🧪 Testing

Create a test route:

use Illuminate\Support\Facades\Log;

Route::get('/test-alert', function () {
    Log::error('Test error from Laravel GChat Alert');
    return 'Alert Sent';
});

Visit:

/test-alert

You should receive a Google Chat alert.

📊 Log Levels

Available levels (highest to lowest severity):

emergency
alert
critical
error
warning
notice
info
debug

If GCHAT_ALERT_LEVEL=error, it will send:

error
critical
alert
emergency

🖥 CLI & Queue Support

This package captures:

HTTP request errors
Artisan command errors
Queue worker failures
Scheduled task errors
Runtime CLI exceptions

🛠 Requirements

PHP 7.4+
Laravel 8 -- 12
Google Chat Incoming Webhook

❌ Troubleshooting

If you are not receiving alerts, check:

LOG_CHANNEL=stack
GCHAT_ALERT_ENABLED=true
Webhook URL is correct
Log level is set correctly
Configuration cache is cleared

Run:

php artisan config:clear
composer dump-autoload

🏷 Versioning

This package follows Semantic Versioning:

v1.0.0 -- Initial release
v1.1.0 -- Feature update
v1.1.1 -- Bug fix

📜 License

MIT License

👤 Author

Savan Rathod

⭐ Support

If you find this package useful, please consider giving it a star on GitHub.

savan / gchat-error-alert

Package info

Security

Statistics