Fatal Error Catcher: Auto-Heal & Crash Logs

2 min read

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 #

  1. Detect: catches fatal PHP errors before they white-screen the site
  2. Contain: automatically deactivates the offending plugin
  3. Keep live: the site stays online; only the crashing plugin’s features pause
  4. 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

Related Articles #

Updated on August 31, 2026