PHPackages soukar/qalert - 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. [Utility & Helpers](/categories/utility) 4. / 5. soukar/qalert ActiveLibrary[Utility & Helpers](/categories/utility) soukar/qalert ============= description v1.2(2w ago)151MITPHP Since Mar 4Pushed 2w ago1 watchersCompare [ Source](https://github.com/mo-soukar/qalert)[ Packagist](https://packagist.org/packages/soukar/qalert)[ RSS](/packages/soukar-qalert/feed)WikiDiscussions main Synced today READMEChangelog (5)DependenciesVersions (8)Used By (0) 🚨 QAlert (Laravel Queue Monitor) ================================ [](#-qalert-laravel-queue-monitor) A simple, expressive tool to monitor your Laravel background jobs and get notified on failures instantly via Telegram and other channels. --- 🚀 Quick Start ------------- [](#-quick-start) ### 1. Install via Composer [](#1-install-via-composer) Run the following command in your terminal: ``` composer require soukar/qalert ``` --- ### 2. Publish Configuration [](#2-publish-configuration) Publish the config file to your project's config directory to customize channels and tokens: ``` php artisan vendor:publish --tag=qalert ``` --- ### 3. Configure your Environment (.env) [](#3-configure-your-environment-env) Add your credentials to your `.env` file to activate the alerts: ``` # Master switch to enable/disable alerts QALERT_ENABLED=true # Telegram Bot Credentials TELEGRAM_BOT_TOKEN=your_bot_token_here TELEGRAM_CHAT_ID=your_chat_id_here # Project name to show in the alert message APP_NAME="My Awesome Service" ``` --- 📝 Custom Logging Channel ------------------------ [](#-custom-logging-channel) You can now use **QAlert** as a standard Laravel logging channel. This allows you to send manual logs or specific application errors directly to your configured channels (like Telegram). ### Setup Logging [](#setup-logging) Add the `qalert` driver to your `config/logging.php` file: ``` 'channels' => [ // ... other channels 'qalert' => [ 'driver' => 'qalert', ], ], ``` --- ⚙️ Configuration File (`config/qalert.php`) ------------------------------------------- [](#️-configuration-file-configqalertphp) After publishing, you can fine-tune the behavior of the package: --- Key Description Default --- `enabled` Globally enable or disable `true`notifications. `project` The project name that appears `APP_NAME`in the alert title. `channels.telegram` Stores the bot token and chat `.env`ID. `default_channel` The fallback channel if none `telegram`is specified. ---------------------------------------------------------------------- [](#default_channel-----the-fallback-channel-if-none---telegramis-specified) --- 🛠 How it Works -------------- [](#-how-it-works) QAlert automatically listens for the `JobFailed` event in Laravel. When a job fails: - It gathers the job details and the exception message. - It processes the event through the configured channels in the `ChannelManager`. - It sends a formatted notification to each active channel (e.g., Telegram). --- 💓 Queue Heartbeat (Stay Alive) ------------------------------ [](#-queue-heartbeat-stay-alive) QAlert isn't just for failed jobs; it also ensures your Queue Workers are actually running. It uses a **Heartbeat** system that leverages Laravel's default Scheduling system. ### How to activate it: [](#how-to-activate-it) 1. Ensure your Laravel Scheduler is running (`* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1`). 2. QAlert will automatically schedule a "Ping" job every hour (or your custom interval). 3. If the Heartbeat job isn't processed within the expected timeframe, you'll receive a **"Queue Stalled"** alert on Telegram. This ensures that even if the `supervisor` stops or the connection to `Redis/Database` is lost, you'll still be the first to know. --- 🤝 Contributing -------------- [](#-contributing) Contributions are welcome! If you'd like to add a new channel (Slack, Discord, SMS), feel free to open a Pull Request. --- ❤️ Author --------- [](#️-author) Developed with ❤️ by **Mohammad Soukar** ### Health Score 40 — FairBetter than 86% of packages Maintenance96 Actively maintained with recent releases Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity39 Early-stage or recently created project 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 ~17 days Recently: every ~25 days Total 7 Last Release 20d ago Major Versions v0.11 → v1.0.02026-03-04 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/98924124?v=4)[Mohammad Soukar](/maintainers/mo-soukar)[@mo-soukar](https://github.com/mo-soukar) --- Top Contributors [![mo-soukar](https://avatars.githubusercontent.com/u/98924124?v=4)](https://github.com/mo-soukar "mo-soukar (10 commits)") ### Embed Badge ![Health badge](/badges/soukar-qalert/health.svg) ``` [![Health](https://phpackages.com/badges/soukar-qalert/health.svg)](https://phpackages.com/packages/soukar-qalert) ``` ### Alternatives [spatie/laravel-pjax A pjax middleware for Laravel 5 523386.8k11](/packages/spatie-laravel-pjax)[gkralik/php-uglifyjs PHP Javascript packer 35304.5k7](/packages/gkralik-php-uglifyjs)[wa72/url Class for handling and manipulating URLs 31236.7k1](/packages/wa72-url) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)