PHPackages                             gauravharsh/module-log-monitor - 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. gauravharsh/module-log-monitor

ActiveMagento2-module[Logging & Monitoring](/categories/logging)

gauravharsh/module-log-monitor
==============================

A smart, memory-efficient background log monitor and deduplicated error dashboard for Adobe Commerce.

1.1.0(1mo ago)042OSL-3.0PHPPHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

Since Mar 29Pushed 1mo agoCompare

[ Source](https://github.com/gauravharsh15/magento-2-logs-monitor)[ Packagist](https://packagist.org/packages/gauravharsh/module-log-monitor)[ RSS](/packages/gauravharsh-module-log-monitor/feed)WikiDiscussions main Synced 2d ago

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

Gaurav Log Monitor for Magento 2
================================

[](#gaurav-log-monitor-for-magento-2)

A professional-grade, high-performance monitoring engine that transforms chaotic `var/log` files into a clean, actionable, deduplicated error dashboard for Adobe Commerce.

📖 Why This Module?
------------------

[](#-why-this-module)

In most Magento environments, log files are a "dark hole." They grow to gigabytes, are rarely checked until a site crashes, and contain thousands of repetitive lines that bury the actual root cause of issues.

**Gaurav\_LogMonitor** was built to solve this by providing:

- **Proactive Health Checks:** Identifies "Silent Killers" like failed background data syncs (ERP/CRM) that don't crash the frontend.
- **Operational Efficiency:** Stops senior developers from wasting hours "log hunting" through massive text files.
- **Server Stability:** Scans 10GB+ logs using near-zero RAM, ensuring the monitoring tool never becomes a bottleneck.
- **Rotation-Aware:** Understands daily-rotated, gzipped log files, so errors written right before rotation aren't silently lost.

---

🖥️ Preview & UI
-------------------

[](#️-preview--ui)

### 1. Unified Error Dashboard

[](#1-unified-error-dashboard)

[![Admin Dashboard Grid](docs/dashboard.png)](docs/dashboard.png)*A consolidated, searchable view of all unique errors across every .log file in your system. This grid groups thousands of identical errors into single, manageable records.*

### 2. Smart Alert Configuration

[](#2-smart-alert-configuration)

[![Module Configuration Settings](docs/config.png)](docs/config.png)*Easily manage your monitoring settings, define custom email recipients, and set alert thresholds.*

---

✅ Feature Overview
------------------

[](#-feature-overview)

FeatureDescription**Byte-offset scanning**Only reads newly-appended bytes on every run, not the whole file — near-zero RAM even on multi-GB logs.**Multi-line trace grouping**Groups a stack trace's continuation lines with the timestamped line that started it into a single error record.**Content-hash deduplication**Identical errors (same file + normalized message) collapse into one row with an incrementing `occurrence_count`, instead of flooding the grid.**Rotated/gzipped archive scanning** *(opt-in)*Reads `exception.log.1`, `exception.log.1.gz`, etc. exactly once (they're immutable once rotated) and merges the results into the same alert history as the live file, closing the gap around rotation time.**Severity classification**Parses `channel.LEVEL:` from each line; unrecognized formats are tagged `UNKNOWN` and kept visible instead of being silently dropped. INFO/DEBUG are filtered out to keep the dashboard focused on actionable errors.**Threshold + recurrence-aware alerting**Emails fire once an error crosses the configured occurrence threshold, and will fire **again** if it keeps recurring after the first email — it doesn't go silent forever after one notification.**Cron overlap protection**A non-blocking lock ensures two scans can't run at once and corrupt the byte-offset state if a run takes longer than the 5-minute schedule.**Per-file fault isolation**A corrupt or unreadable log file is skipped and logged — it doesn't abort the scan for every other file that run.**Automatic retention cleanup**A daily job purges alerts that haven't been seen within a configurable retention window, so the table doesn't grow forever.**Deduplicated admin grid**Filter/sort by severity, log file, occurrence count, email status, first/last seen; drill into the full stack trace per alert.**Scoped ACL**Dashboard and Settings are gated behind their own admin permissions, not the generic backend/admin resource.---

⚙️ Configuration & Navigation
---------------------------------

[](#️-configuration--navigation)

After installation, you can manage the module and view alerts via the following paths:

### Admin Dashboard (The Grid)

[](#admin-dashboard-the-grid)

Navigate to: **System > Log Monitor Alerts***This is the central command center where you view, filter, and mass-delete deduplicated error logs.*

### System Configuration

[](#system-configuration)

Navigate to: **Stores > Configuration > Gaurav Extensions > Log Monitor**

**General Settings**

- **Enable Module:** Master switch for the background scanner and alert emails.
- **Ignore Log Files:** Comma-separated filenames to skip entirely (e.g. `debug.log, custom.log`).
- **Scan Rotated/Gzipped Archives:** Off by default. Turn on if your server rotates + gzips logs (e.g. daily via `logrotate`) and you want those archives scanned once so nothing written right before rotation is missed.
- **Alert Retention (Days):** How long an alert is kept after it was last seen before the daily cleanup job deletes it. `0` disables cleanup entirely.

**Email Alert Settings**

- **Recipient Emails:** Comma-separated list of developers to receive alert emails. Falls back to the store's General Contact email if left blank.
- **Minimum Occurrences Threshold:** How many times an error must occur (since it was last emailed, or since it was first seen) before an alert email is sent.

---

🏗️ Business Flow
----------------

[](#️-business-flow)

### 1. Scanning — `logmonitor_process` cron (every 5 minutes) / `bin/magento logmonitor:process`

[](#1-scanning--logmonitor_process-cron-every-5-minutes--binmagento-logmonitorprocess)

1. Skip entirely if the module is disabled.
2. Acquire a non-blocking lock; if a previous scan is still running (e.g. a very large log took longer than 5 minutes), skip this run rather than racing it.
3. List `var/log`. For each `*.log` file not on the ignore list:
    - Load its last-read byte offset from the state table.
    - If the file shrank since last time (rotation happened) or a full reset was requested, restart from byte 0.
    - Skip if there's no new data.
    - Seek straight to the last offset and stream new lines with `fgets()` — no full-file load.
    - A line starting with a Magento timestamp (`[YYYY-MM-DD HH:MM:SS]`) begins a new error block; every following non-timestamped line (stack trace) is appended to it, capped at 500 lines / 64KB so a malformed file can't balloon memory.
    - Extract severity from `channel.LEVEL:`; unmatched formats become `UNKNOWN` rather than being dropped as `INFO`.
    - Normalize the line (timestamp stripped) and MD5-hash it — this hash plus the log file name is the dedup key.
    - Save the byte offset actually reached back to the state table.
    - A failure on one file is logged and the loop continues with the next file.
4. If archive scanning is enabled, also walk any `*.log.N` / `*.log.N.gz` files. Each archive is checked against a separate "already processed" table (keyed by name + size, since archives never change once written) and, if new, read fully exactly one time — then tagged as processed so it's never re-read.
5. Release the lock.

### 2. Deduplication — inside every save

[](#2-deduplication--inside-every-save)

- INFO/DEBUG severities are discarded immediately; everything else is kept.
- The alert is looked up by the exact `(log_file, error_hash)` pair.
- **Exists:** `occurrence_count` +1, `last_seen_at` refreshed. The stored trace isn't rewritten (same hash implies effectively the same trace).
- **New:** a row is created with severity, a 250-character preview, the full trace (capped at 20,000 characters), `occurrence_count = 1`, and `is_notified = 0`.

### 3. Alerting — `logmonitor_send_alerts` cron (hourly)

[](#3-alerting--logmonitor_send_alerts-cron-hourly)

1. Skip if disabled.
2. Select every alert where `occurrence_count - last_notified_count >= threshold` — this covers brand-new alerts that just crossed the threshold **and** previously-notified alerts that have recurred by `threshold` more occurrences since their last email.
3. Compute the combined size and most recent modified time across all `.log` files for the email header.
4. Render `log_alert.html` with the alert previews (not full traces, to keep emails small) and send to the configured recipients.
5. On success, mark `is_notified = 1` and snapshot `last_notified_count = occurrence_count` for every alert included — so the next alert only fires after further recurrence, not on every single scan.
6. Send failures fail silently and are simply retried next hour, since the notified markers were never updated.

### 4. Cleanup — `logmonitor_cleanup` cron (daily, 2:30am)

[](#4-cleanup--logmonitor_cleanup-cron-daily-230am)

- If retention is enabled (> 0 days), deletes any alert whose `last_seen_at` is older than the configured window.

### 5. Investigation — Admin Dashboard

[](#5-investigation--admin-dashboard)

- **System > Log Monitor Alerts** lists every deduplicated alert: severity, log file, preview, occurrence count, email status (Pending/Emailed), first seen, last seen — all filterable and sortable.
- **View** opens the full stack trace for a single alert.
- **Mass Delete** clears out selected alerts (there is currently no separate "resolve/mute" state — deleting is how an alert is cleared from the grid; if the same error recurs afterward it will simply be recreated as new).

---

📋 Requirements
--------------

[](#-requirements)

- **PHP:** 8.1, 8.2, 8.3, or 8.4. The module has no version-specific syntax (no `match`/`enum`/`readonly`/arrow-fn-only constructs, no removed-in-8.0 functions), so it isn't tied to a narrow PHP release.
- **Magento:** 2.3.6+ (the cron scanner uses `Magento\Framework\Lock\LockManagerInterface`, introduced in 2.3.6, to prevent overlapping scans on large log files). In practice, run it on whatever Magento 2.4.x version your PHP install already requires — the PHP range above tracks Magento's own currently-supported versions rather than a narrower artificial floor.

🛠️ Installation & Setup
---------------------------

[](#️-installation--setup)

```
composer require gauravharsh/module-log-monitor
bin/magento module:enable Gaurav_LogMonitor
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance94

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity55

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

Total

4

Last Release

33d ago

PHP version history (2 changes)1.0.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0

1.1.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8842b2b72052bd3b34c732ce665cf8897bc7c05c4986442b9849b6ccbbd934db?d=identicon)[gauravharsh15](/maintainers/gauravharsh15)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/gauravharsh-module-log-monitor/health.svg)

```
[![Health](https://phpackages.com/badges/gauravharsh-module-log-monitor/health.svg)](https://phpackages.com/packages/gauravharsh-module-log-monitor)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.5M1](/packages/fastly-magento2)[graycore/magento2-stdlogging

A Magento 2 module that changes all logging handlers to stdout

2589.7k](/packages/graycore-magento2-stdlogging)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1861.2k](/packages/myparcelnl-magento)[mage-os/module-admin-activity-log

The Admin Activity extension makes it easy to track all admin activity with comprehensive audit logging.

2911.6k1](/packages/mage-os-module-admin-activity-log)[mage-os/module-automatic-translation

Automatic AI content translation for Mage-OS.

3123.7k](/packages/mage-os-module-automatic-translation)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1015.1k29](/packages/loki-magento2-components)

PHPackages © 2026

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