Bugsnag con WordPress: setup e best practice

Bugsnag per WordPress: integrazione

Bugsnag è un'altro strumento di error tracking moderno, con focus su stability score (percentuale sessioni senza errori) e release pipeline. Vediamo come integrarlo con WordPress e farlo convivere con WP Error Monitor.

Bugsnag vs Sentry

Bugsnag punta sul concetto di 'stability scorè: la percentuale di sessioni utente che NON hanno avuto errori. Utile come KPI di qualità. Sentry ha source map più raffinato e free tier più generoso. Entrambi hanno SDK PHP. Bugsnag è migliore per team che vogliono unico KPI da comunicare al management.

Setup PHP WordPress

Installa SDK via Composer: composer require bugsnag/bugsnag. In mu-plugin: Bugsnag\Client::make('YOUR_API_KEY'). L’SDK gestisce error_handler e exception_handler. Usa releaseStage per distinguere prod/staging/dev. notifyReleases() permette di marcare deploy.

Coesistenza con WP Error Monitor

Entrambi possono coesistere: i due agent chain gli handler PHP. Per evitare alert duplicati configura WP Error Monitor a inoltrare solo CRITICAL ad alert Slack, mentre Bugsnag riceve tutto per analytics. Così' usi Bugsnag come 'archivio analitico' e WP Error Monitor come 'pronto intervento'.

Stability score come KPI

Stability score si calcola come rapporto tra sessioni senza errori e sessioni totali. Bugsnag lo calcola per ogni release. Best practice: target stability score sopra 99.5% per produzione. Settimanale review: se scende sotto target, priorità alta a fix top errors. La metrica funziona se hai abbastanza traffico: per siti piccoli (sotto 1k sessioni/giorno) è rumorosa. WP Error Monitor calcola metrica simile come error rate.

Workflow team con assignment

Bugsnag permette assegnazione errori a team member: vista 'My issues' mostra cosa ognuno deve risolvere. Integrazione con Jira/Linear/GitHub: l’errore Bugsnag crea automaticamente issue nel tracker, con due-way sync. Quando issue tracker viene chiuso, errore Bugsnag viene marked resolved. Stesso flow su WP Error Monitor con integrazione tickets Perfex CRM.

Release health monitoring

Bugsnag Release Health tracking misura stability score per ogni release: se la nuova release ha score 99% e la precedente 99.8%, regression rilevata automaticamente. UI mostra side-by-side comparison: vedi quali errori sono nuovi nella nuova release. Setup: nel deploy script chiama bugsnag-cli per registrare release con commit hash. WP Error Monitor offre tracking simile basato su deploy_id passato via env var WPEM_DEPLOY_ID. Comparison pre/post deploy in dashboard mostra impact analysis. Best practice: trigger rollback automatico se stability score scende oltre soglia (es. >0.5%) entro 1h dal deploy.

Integration con Source Maps

Per debug JavaScript minified in produzione, Source Maps sono critici: permettono di vedere file originale invece di codice minified. Bugsnag e Sentry consumano source map automaticamente se uploaded prima del deploy. Setup webpack: configure devtool 'source-map' (genera .map files), upload via bugsnag-cli verso Bugsnag API. WP Error Monitor JS snippet supporta source map analogamente con upload via wp wpem upload-sourcemap. Source map dovrebbero NON essere serviti pubblicamente (esporrebbero codice): proteggi con auth header o solo locale upload.

Bugsnag vs Sentry decision matrix

Decision matrix Bugsnag vs Sentry per WordPress: scegli Bugsnag se vuoi forte focus su stability score come KPI singolo da comunicare al management, integration con mobile app companion. Scegli Sentry se vuoi free tier più generoso (5k events gratis), source map JS migliori, ecosystem più ricco. Entrambi coesistono con WP Error Monitor senza conflitti. Tipicamente i clienti G Tech enterprise usano Sentry (free tier sufficient per maggior parte siti) + WP Error Monitor (incluso nel piano managed). Bugsnag è alternativa valida per chi già lo usa in altri stack.

Integration testing per error tracking

Configura test di integrazione che generano errori sintetici controllati e verificano l’arrivo in Bugsnag/Sentry/WP Error Monitor. Così' confermi che il monitoring funziona davvero: nessuna sorpresa in incident reale quando scopri che la cattura era rotta da settimane silenziosamente.

Procedura passo-passo

  1. Crea progetto Bugsnag e prendi API key.
  2. Composer require bugsnag/bugsnag.
  3. Crea mu-plugin wpem-bugsnag-init.php con Bugsnag\Client::make(API_KEY).
  4. Configura releaseStage in base a wp_get_environment_type().
  5. Aggiungi Bugsnag Browser SDK per JS frontend.
  6. Genera test error e verifica arrivo su dashboard Bugsnag.
  7. Configura WP Error Monitor per alert solo CRITICAL, lascia il resto a Bugsnag.
  8. Definisci stability score target (es. 99.5%) e monitora trend.
  9. Definisci stability score target per cliente.
  10. Configura integrazione Jira/Perfex per assignment automatico.

Errori comuni e come risolverli

  • Notifications non arrivano: API key errata o firewall: verifica connettività a notify.bugsnag.com.
  • Source map JS non funziona: Carica source map via bugsnag-cli durante deploy.
  • Conflitto con altri error handler: Usa Bugsnag::leaveBreadcrumb prima di set_error_handler altri.
  • Stability score sempre basso: Pattern errori sistemici: investigazione approfondita necessaria.
  • Sync Jira-Bugsnag stuck: API token scaduto: rinnova in entrambi i sistemi.

Domande frequenti

D: Costi Bugsnag?
R: Free fino 7.5k eventi/mese, poi piani da 59$/mese.

D: Posso esportare dati Bugsnag?
R: Sì, API REST e webhook per export verso datawarehouse.

D: WP Error Monitor invia a Bugsnag?
R: Sì, via webhook generico configurabile.

D: Bugsnag mobile app utile?
R: Sì, notifiche push e overview rapida.

D: Posso esportare stability score?
R: Sì, via API REST in dashboard custom Grafana.

Hai bisogno di aiuto?

Se vuoi affidare il monitoraggio WordPress al team di G Tech Group, scrivici tramite il modulo di contatto.

Hai trovato utile quest'articolo?