README

gboquizosanchez/google-chat-channel

Laravel logging channel for Google Chat

Get instant alerts in Google Chat when your Laravel app logs an error. No setup beyond a webhook URL.

Overview

A lightweight Laravel logging channel that sends log entries directly to a Google Chat space via webhooks. Messages are formatted as rich cards with emojis based on log level — so your team can triage errors at a glance without leaving Chat.

✨ Features

• 🚀 Real-time delivery — Log entries sent instantly to your Google Chat space
• 📱 Rich formatting — Cards with emojis and severity based on log level
• ⚙️ Env-based config — No config file to publish, just .env variables
• 🔧 Context & exceptions — Optionally include extra context and exception details
• 📊 Smart retries — Built-in error handling for webhook failures
• 🔁 Queue support — Optionally queue log dispatch to avoid blocking requests

📦 Installation

composer require gboquizosanchez/google-chat-channel

⚙️ Configuration

Add the channel to your config/logging.php:

'channels' => [
    'google-chat' => [
        'driver' => 'custom',
        'via'    => \Boquizo\GoogleChatChannel\GoogleChatLogger::class,
    ],

    'stack' => [
        'driver'   => 'stack',
        'channels' => ['single', 'google-chat'],
    ],
],

Then set your webhook URL in .env:

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

To get a webhook URL, open a Google Chat space → Manage webhooks → Add webhook.

Available environment variables

🚀 Usage

Once configured, use Laravel's standard logging — no changes needed in your code:

// Sent to Google Chat (at or above your configured level)
Log::error('Payment failed', ['order_id' => 1234]);
Log::critical('Database connection lost');

// Not sent if GOOGLE_CHAT_LOG_LEVEL=error
Log::info('User logged in');

Each message arrives in Chat as a formatted card showing the level, message, and optionally context or exception details.

Contributing

Contributions are welcome!

• 🐛 Report bugs via GitHub Issues
• 💡 Suggest features or improvements
• 🔧 Submit pull requests with fixes or enhancements

Credits

• Author: Germán Boquizo Sánchez
• Contributors: View all contributors

📄 License

This package is open-source software licensed under the MIT License.