PHPackages                             mohamedsamy902/laravel-pulse-alert - 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. [Logging & Monitoring](/categories/logging)
4. /
5. mohamedsamy902/laravel-pulse-alert

ActiveLibrary[Logging & Monitoring](/categories/logging)

mohamedsamy902/laravel-pulse-alert
==================================

A zero-configuration Laravel package for real-time error monitoring, Telegram alerts, daily email reports, and suspicious traffic detection.

v1.2.0(3mo ago)00MITPHPPHP ^8.2CI failing

Since Mar 17Pushed 3mo agoCompare

[ Source](https://github.com/MohamedSamy902/laravel-pulse-alert)[ Packagist](https://packagist.org/packages/mohamedsamy902/laravel-pulse-alert)[ RSS](/packages/mohamedsamy902-laravel-pulse-alert/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (9)Versions (5)Used By (0)

⚡ Laravel Pulse Alert
=====================

[](#-laravel-pulse-alert)

[Arabic Version (النسخة العربية)](README_AR.md)

[![Latest Version on Packagist](https://camo.githubusercontent.com/06edff0f342f53c02b153068adaaca4eb1a2bfe0bca4e228ba4b285416b6b28d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f68616d656473616d793930322f6c61726176656c2d70756c73652d616c6572742e737667)](https://packagist.org/packages/mohamedsamy902/laravel-pulse-alert)[![PHP Version](https://camo.githubusercontent.com/87a9b94eb012dd8b2e6f9b91a6ceda9768e1bb9ea33ea60f540c3490534683ad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d626c7565)](https://php.net)[![Laravel Version](https://camo.githubusercontent.com/ca0e14b1ee59facc7c47912dc564374313f02d57d5d1ca4c16b9d478291aad66/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d313125374331322d726564)](https://laravel.com)[![License: MIT](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

> Real-time error monitoring, intelligent alerts, and traffic surveillance for Laravel applications.

PulseAlert is a lightweight, zero-configuration package designed to keep you informed about your application's health. It goes beyond simple logging by classifying errors, sending instant Telegram notifications for critical issues, and providing daily summaries.

✨ Features
----------

[](#-features)

- **Intelligent Priority Engine**: Automatically classifies exceptions (CRITICAL, HIGH, MEDIUM, LOW).
- **Telegram Instant Alerts**: Receive 🔴 Critical and 🟠 High priority alerts directly on Telegram.
- **Smart Rate Limiting**: Prevents alert spam by silencing duplicate errors for 10 minutes.
- **Traffic Surveillance**: Middleware to detect and notify about suspicious request volume from single IPs.
- **Daily Error Digest**: Beautifully formatted email summaries sorted by importance.
- **Data Sanitization**: Automatically scrubs sensitive data (passwords, tokens) from stack traces.

🚀 Installation
--------------

[](#-installation)

### Step 1 — Install via Composer

[](#step-1--install-via-composer)

```
composer require mohamedsamy902/laravel-pulse-alert
```

### Step 2 — Publish Config & Migrations

[](#step-2--publish-config--migrations)

```
php artisan vendor:publish --tag=pulse-alert-config
php artisan vendor:publish --tag=pulse-alert-migrations
```

### Step 3 — Run Migrations

[](#step-3--run-migrations)

```
php artisan migrate
```

📋 Configuration
---------------

[](#-configuration)

### Environment Variables

[](#environment-variables)

Add these keys to your `.env` file:

VariableDescriptionDefault`PULSE_ALERT_TELEGRAM_TOKEN`Your Telegram Bot Token (@BotFather)`null``PULSE_ALERT_TELEGRAM_CHAT_ID`Your Telegram Chat/Group ID`null``PULSE_ALERT_TELEGRAM_ENABLED`Toggle Telegram alerts`true``PULSE_ALERT_TELEGRAM_QUEUE`Set `false` for instant delivery without Worker`false``PULSE_ALERT_LOCALE`Message language (`en` or `ar`)`en``PULSE_ALERT_MAIL_TO`Recipient for daily reports`null``PULSE_ALERT_MAIL_ENABLED`Toggle email reports`true``PULSE_ALERT_REPORT_TIME`Departure time for daily report`08:00``PULSE_ALERT_RATE_MAX`Max requests allowed per window`20``PULSE_ALERT_RATE_WINDOW`Time window in minutes`1`### Registering the Logger (Laravel 11/12)

[](#registering-the-logger-laravel-1112)

In your `bootstrap/app.php`, register the PulseAlert logger within the `withExceptions` block:

```
use MohamedSamy902\PulseAlert\Services\ErrorLogger;

// ...
->withExceptions(function (Exceptions $exceptions) {
    app(ErrorLogger::class)->register($exceptions);
})
```

### Scheduling the Daily Report

[](#scheduling-the-daily-report)

In your `routes/console.php`, schedule the report to run daily:

```
use Illuminate\Support\Facades\Schedule;

Schedule::command('pulse-alert:daily-report')->dailyAt('08:00');
```

📖 Usage
-------

[](#-usage)

### Automatic Traffic Surveillance

[](#automatic-traffic-surveillance)

The package automatically registers its rate-limiting middleware globally. All requests (Web, API, Dashboard) are monitored by default using the settings in your config file.

### Manual Logging

[](#manual-logging)

You can manually log errors with a specific priority if needed:

```
use MohamedSamy902\PulseAlert\Services\ErrorLogger;

try {
    // ... code
} catch (\Exception $e) {
    app(ErrorLogger::class)->log($e, 'CRITICAL');
}
```

🎯 Priority Classification Logic
-------------------------------

[](#-priority-classification-logic)

- **CRITICAL**: Database errors, 500 status codes, or severe engine errors. (Instant Alert 🔴)
- **HIGH**: Keywords like "payment", "unauthorized", "auth", or "token" detected in message. (Instant Alert 🟠)
- **MEDIUM**: General exceptions that don't match critical/high criteria. (Daily Report only)
- **LOW**: Minor issues or manually logged low-priority events. (Daily Report only)

🧪 Testing
---------

[](#-testing)

```
composer test
```

📄 License
---------

[](#-license)

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

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance81

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 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 ~0 days

Total

4

Last Release

102d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/37915355?v=4)[Mohamed Samy](/maintainers/MohamedSamy902)[@MohamedSamy902](https://github.com/MohamedSamy902)

---

Top Contributors

[![MohamedSamy902](https://avatars.githubusercontent.com/u/37915355?v=4)](https://github.com/MohamedSamy902 "MohamedSamy902 (4 commits)")

---

Tags

laravelloggingmonitoringerroralertstelegrampulse

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mohamedsamy902-laravel-pulse-alert/health.svg)

```
[![Health](https://phpackages.com/badges/mohamedsamy902-laravel-pulse-alert/health.svg)](https://phpackages.com/packages/mohamedsamy902-laravel-pulse-alert)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.6k](/packages/larastan-larastan)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[flarum/core

Delightfully simple forum software.

201.4M2.2k](/packages/flarum-core)[calebdw/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

15104.9k4](/packages/calebdw-larastan)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)