Overview #
A fatal error in a plugin can white-screen a site in seconds. XPulse includes a fatal error catcher that detects crashes, keeps the site online, and notifies the team: turning a potential outage into a logged incident.
The Alerts #
| Alert | Meaning |
|---|---|
| Auto-Healed Fatal Crash (critical) | A fatal error was caught and the offending plugin was auto-deactivated to keep the site live |
| Plugin Crash Logged (warning) | A plugin crashed but the site stayed online: the crash was logged for review |
What the Auto-Healer Does #
- Detect: catches fatal PHP errors before they white-screen the site
- Contain: automatically deactivates the offending plugin
- Keep live: the site stays online; only the crashing plugin’s features pause
- Notify: the team (and optionally you) get an alert with the crash details
This is the difference between a 5-minute contained incident and a down site.
What the Crash Log Tells You #
Each logged crash records:
– Which plugin threw the error
– The error message and file/line
– When it happened
– The page/context where it occurred
Reviewing the Log #
- XPulse dashboard: crash history with the details above
- Server logs: PHP error log (GridPane: control panel → logs)
- WP-CLI:
wp eval 'print_r(json_decode(get_option("xpulse_crash_log", "[]"), true));'
After a Crash #
| State | What happens next |
|---|---|
| Auto-healed | The plugin stays deactivated until it’s safe. We review the log, check for an update/fix, and re-enable only when safe: or recommend a replacement |
| Logged only | Site stayed up. We review and monitor; if it recurs we escalate to deactivation or replacement |
Webhook Alerts #
Crash events can push to a webhook (Slack, Discord, or your monitoring stack) so your team hears about incidents even outside the dashboard. Request webhook setup via support.
What You Should Do #
- Check what stopped working: whatever that plugin powered (forms, gallery, shop feature) is temporarily off
- Tell us what changed recently: an update or new plugin before the crash is a strong clue
- If you were using the feature at the time, mention it: context helps us reproduce and fix faster