PHPackages                             blackbird/magento2-index-monitoring - 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. blackbird/magento2-index-monitoring

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

blackbird/magento2-index-monitoring
===================================

Magento 2 module for monitoring indexers and mview states with email alerts

1.0.3(1mo ago)135↓44.4%1MITPHPPHP ^8.1|^8.2|^8.3

Since Mar 3Pushed 1mo agoCompare

[ Source](https://github.com/blackbird-agency/magento2-index-monitoring)[ Packagist](https://packagist.org/packages/blackbird/magento2-index-monitoring)[ RSS](/packages/blackbird-magento2-index-monitoring/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (10)Versions (5)Used By (0)

### Blackbird Index Monitoring (Magento 2.4.6 / PHP 8.3)

[](#blackbird-index-monitoring-magento-246--php-83)

Magento index and mview state monitoring module.

Features:

- Email alert if an indexer remains in "working" status beyond a threshold (configurable, 60 minutes by default).
- Email alert if a mview\_state is in "suspended" or (if used by a third-party module) "error" status.
- Email alert if a mview\_state remains in "working" status beyond the same threshold.
- Cron job every 5 minutes (can be enabled/disabled via configuration).
- Anti-spam: only one email per incident sequence (resent only if the list of incidents changes or becomes empty then errors again).
- Dedicated log file: var/log/blackbird\_index\_monitoring.log (ERROR level).
- Admin action to bulk reset mview states (System > Index Management > Mview States).
- Console command to check indexer status on demand.

Installation:

### Via Composer

[](#via-composer)

```
composer require blackbird/magento2-index-monitoring
bin/magento module:enable Blackbird_IndexMonitoring
bin/magento setup:upgrade
bin/magento cache:flush
```

Configuration (Admin):

- Stores > Configuration > Advanced > Blackbird - Index Monitoring
    - Enable monitoring (Yes/No)
    - Stuck threshold (minutes)
    - Email recipients (comma-separated email addresses)

Admin Actions:

- System > Index Management > Mview States
    - View all mview states with their status and updated time
    - Mass action to reset mview states to "idle" status

Console Commands:

- bin/magento blackbird:indexer:check-status
    - Manually check indexer and mview status
    - Returns exit code 1 if issues are detected (useful for CI/CD pipelines)

Technical Details:

- Cron: etc/crontab.xml (\*/5 \* \* \* \*), class: Blackbird\\IndexMonitoring\\Model\\Cron\\MonitorJob
- Detection:
    - Indexers: Magento\\Indexer\\Model\\Indexer\\Collection, "working" status + updated field (epoch) > threshold
    - Mview: Magento\\Framework\\Mview\\View\\State\\CollectionInterface, "suspended" or "error" statuses, or "working" too long
- Notification: email template etc/email\_templates.xml, file view/frontend/email/index\_alert.html, sender: "General" identity
- Deduplication: persistent digest in database via Custom Variable (variable/variable\_value tables), code: blackbird\_index\_monitoring\_last\_digest (Global scope / store\_id=0)
- Dedicated log: var/log/blackbird\_index\_monitoring.log

Notes:

- The "error" mview status is not standard in Magento (idle/working/suspended). The module interprets it if set by a third party.
- Email is sent only if at least one valid recipient is configured.

Troubleshooting:

- Check Magento cron (system.cron) and server cron jobs.
- Review var/log/blackbird\_index\_monitoring.log for alert records.
- Useful commands:
    - bin/magento indexer:status
    - bin/magento indexer:show-mode
    - bin/magento indexer:reset <indexer\_id>
    - bin/magento indexer:reindex <indexer\_id>
    - bin/magento blackbird:indexer:check-status

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance91

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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

Total

4

Last Release

44d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12445118?v=4)[anthony-blackbird](/maintainers/anthony-blackbird)[@anthony-blackbird](https://github.com/anthony-blackbird)

---

Top Contributors

[![matthieu-blackbird](https://avatars.githubusercontent.com/u/112162474?v=4)](https://github.com/matthieu-blackbird "matthieu-blackbird (8 commits)")

### Embed Badge

![Health badge](/badges/blackbird-magento2-index-monitoring/health.svg)

```
[![Health](https://phpackages.com/badges/blackbird-magento2-index-monitoring/health.svg)](https://phpackages.com/packages/blackbird-magento2-index-monitoring)
```

###  Alternatives

[magepal/magento2-gmailsmtpapp

Magento 2 SMTP Extension - Configure Magento 2 to send all transactional email using Gmail, G Suite, Amazon SES, Office360, Mailgun, SendGrid, Mandrill or any other SMTP servers

3321.8M2](/packages/magepal-magento2-gmailsmtpapp)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[kiwicommerce/module-admin-activity

The Admin Activity extension makes it easy to track all admin activity and revert the modification.

102407.9k](/packages/kiwicommerce-module-admin-activity)[catgento/module-admin-activity

The Admin Activity extension makes it easy to track all admin activity and revert the modification.

64102.6k](/packages/catgento-module-admin-activity)[mage-os/module-admin-activity-log

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

261.4k](/packages/mage-os-module-admin-activity-log)[graycore/magento2-stdlogging

A Magento 2 module that changes all logging handlers to stdout

2382.6k](/packages/graycore-magento2-stdlogging)

PHPackages © 2026

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