PS PrestaShop Principiante

Monitoraggio e Avvisi PrestaShop (DataFirefly Monitor)

Installare DataFirefly Monitor 2.0.0 su PrestaShop da 1.7.8 a 9, pianificare il cron, configurare i canali di avviso, le pagine monitorate e le regole, e capire ogni rilevamento.

Aggiornato Versione del modulo 2.0.0

DataFirefly Monitor sorveglia il negozio PrestaShop senza sosta e ti avvisa quando va offline, si blocca, rallenta o smette di incassare. Indica il modulo più probabilmente responsabile, invia un solo avviso per problema e ti dice quando tutto è tornato alla normalità. Questa documentazione riguarda la versione 2.0.0.

Dashboard: problema critico in corso, avvisi aperti e indicatori del negozio
Dashboard: problema critico in corso, avvisi aperti e indicatori del negozio

Installazione e aggiornamento

Requisiti

  • PrestaShop da 1.7.8 a 9.x, multinegozio e multilingua
  • PHP da 7.1 a 8.5, con cURL (consigliato)
  • Un’attività cron ogni 5 minuti (consigliato, vedi sotto)

Installazione

  1. Nel back office apri Moduli > Gestione moduli, clicca su Carica un modulo e invia dfmonitor-2.0.0.zip.
  2. Il modulo crea le sue tabelle e la scheda Parametri Avanzati > Monitoraggio e avvisi. Il pulsante Configura del modulo porta direttamente lì.
  3. All’installazione l’email del negozio è usata come destinatario e lo stato Errore di pagamento è scelto come stato di fallimento. I log di PrestaShop scritti prima dell’installazione non vengono importati.

Aggiornamento dalla 1.x

Carica il nuovo zip sopra il vecchio: lo script di aggiornamento aggiunge le nuove colonne e impostazioni senza toccare i tuoi dati. Storico degli errori, avvisi, notifiche, impostazioni e token del cron vengono conservati, quindi l’URL del cron che usi già continua a funzionare.

Dashboard

L’intestazione riassume lo stato del negozio in una frase: Tutto funziona, un avvertimento o un problema critico. Sotto trovi gli avvisi aperti con i pulsanti Prendi in carico e Chiudi, poi sei indicatori: disponibilità sulle 24 ore, tempo di risposta sull’ultima ora (p95), errori PHP sulle 24 ore, pagamenti falliti, ordini di oggi confrontati con l’attività abituale e server.

La striscia di disponibilità mostra le ultime 24 ore a intervalli di 15 minuti. La scheda Pagine monitorate elenca la home page e le pagine aggiuntive con l’ultimo codice HTTP, il tempo di risposta e la disponibilità sulle 24 ore.

Disponibilità sulle 24 ore e pagine monitorate con testo atteso, codice HTTP e tempo di risposta
Disponibilità sulle 24 ore e pagine monitorate con testo atteso, codice HTTP e tempo di risposta

Due grafici mostrano il tempo di risposta (media e p95) e gli errori PHP per ora sulle 24 ore, seguiti dagli ultimi errori e dai tipi di pagina più lenti.

Grafici del tempo di risposta (media e p95) e degli errori PHP per ora, tipi di pagina più lenti
Grafici del tempo di risposta (media e p95) e degli errori PHP per ora, tipi di pagina più lenti

Attività cron

Gli errori fatali e i pagamenti falliti sono segnalati in tempo reale. Tutto il resto (disponibilità, tempo di risposta, ordini, stato del server, report) è valutato da un’attività pianificata da eseguire ogni 5 minuti.

Cron del server (consigliato)

*/5 * * * * php /percorso/di/prestashop/modules/dfmonitor/cron.php

Il comando esatto, con il percorso del tuo server, è indicato in Impostazioni > Controlli pianificati con un pulsante Copia. Eseguilo con l’utente del server web. cron.php rifiuta qualsiasi chiamata che non arrivi dalla riga di comando.

Cron tramite URL

Se il tuo hosting consente solo cron web, chiama l’URL indicato nella stessa scheda dal pannello di hosting o da un servizio come cron-job.org. Il token può anche essere inviato nell’intestazione X-Dfmonitor-Token. Senza il token giusto l’indirizzo risponde 403 e non rivela nulla. Con il token, la risposta indica solo stato, durata e numero di avvisi aperti: nessun percorso, versione o messaggio di errore. Tramite questo URL i controlli girano al massimo una volta al minuto, e Genera un nuovo token invalida il precedente.

Controlli pianificati: cron del server, URL del cron protetto da token, heartbeat esterno e conservazione
Controlli pianificati: cron del server, URL del cron protetto da token, heartbeat esterno e conservazione

Senza cron

Con PHP-FPM l’opzione Alternativa senza cron avvia i controlli dal traffico dei visitatori quando nessun cron è stato eseguito da 10 minuti, dopo l’invio della pagina. Il controllo di disponibilità e l’heartbeat non girano in questa modalità. Con Apache mod_php il cron è indispensabile.

Heartbeat esterno

Il modulo non può segnalare un guasto completo del server. Crea un controllo su Healthchecks.io o Better Stack e incolla il suo URL in URL di heartbeat: viene chiamato a ogni esecuzione del cron e il servizio ti avvisa quando le chiamate si interrompono.

Canali di notifica

Attiva tutti i canali che vuoi in Impostazioni > Canali di notifica. Ogni canale ha una gravità minima (avvertimento e critico, o solo critico) e un pulsante Salva e invia una prova. Il risultato dell’ultimo invio compare sotto il nome del canale.

Canali di avviso: email, Telegram, Slack, Discord e webhook, token salvati e nascosti
Canali di avviso: email, Telegram, Slack, Discord e webhook, token salvati e nascosti

I segreti non vengono mai più mostrati. Una volta salvati, i webhook Slack e Discord, il token Telegram, l’URL del webhook e il suo segreto e l’URL di heartbeat sono nascosti: il campo resta vuoto con un indizio come https://hooks.slack.com/...7f3a. Lascialo vuoto per mantenere il valore, inseriscine uno nuovo per sostituirlo oppure clicca su Rimuovi.

Email

Inserisci uno o più destinatari separati da virgole. Le email usano la configurazione email di PrestaShop (Parametri Avanzati > Email). La Lingua degli avvisi vale per tutti i canali; per impostazione predefinita è la lingua del negozio. Le email esistono in italiano, inglese, francese, spagnolo, tedesco, olandese, polacco e portoghese.

Email di avviso di un errore fatale PHP con origine probabile e pulsante per confermare
Email di avviso di un errore fatale PHP con origine probabile e pulsante per confermare

Telegram

  1. In Telegram apri @BotFather, invia /newbot e segui le istruzioni.
  2. Incolla il token ricevuto in Token del bot.
  3. Invia un messaggio al tuo bot, o aggiungilo a un gruppo, poi clicca su Rileva la mia chat: l’ID chat si compila da solo.

Slack e Discord

Slack: Apps > Incoming Webhooks > Add to Slack, scegli il canale e copia l’URL che inizia con https://hooks.slack.com/. Discord: Impostazioni server > Integrazioni > Webhook > Nuovo webhook, poi Copia URL del webhook.

Webhook

Per Zapier, Make, n8n, uno strumento di reperibilità o il tuo script. Viene inviato un POST JSON per ogni nuovo avviso, promemoria e risoluzione, con l’intestazione X-DataFirefly-Event (open, repeat, resolved, test). Il corpo contiene event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop e sent_at. Con un segreto di firma, ogni richiesta riporta X-DataFirefly-Signature: sha256=…, l’HMAC SHA-256 del corpo grezzo.

Per sicurezza, gli indirizzi della rete privata, del server stesso e dei servizi di metadati cloud sono rifiutati, e i reindirizzamenti non vengono seguiti. Se il tuo strumento è ospitato sulla tua rete, attiva Consenti un webhook sulla rete privata; gli indirizzi dei metadati cloud restano rifiutati.

Regole di avviso

  • Promemoria per un avviso in corso: intervallo tra due notifiche sullo stesso problema (60 minuti per impostazione predefinita). Un problema che peggiora, da avvertimento a critico, viene notificato subito.
  • Numero massimo di notifiche all’ora: 20 per impostazione predefinita, 0 per nessun limite. Un avviso inviato su più canali conta una volta. Un messaggio trattenuto appare come Trattenuto nel registro e parte più tardi.
  • Risolvi dopo: numero di controlli positivi di seguito prima di chiudere un avviso (2 per impostazione predefinita), così un valore che oscilla intorno a una soglia non invia messaggi di apertura e risoluzione a ripetizione.
  • Messaggio di risoluzione: un messaggio parte quando un problema notificato scompare.
  • Privacy: gli indirizzi email presenti nei messaggi di errore sono mascherati in Slack, Telegram, Discord e nel webhook (attivo per impostazione predefinita).
  • Ore di quiete: nella fascia scelta partono solo gli avvisi critici; gli avvertimenti attendono la fine della fascia.
  • Report riepilogativo via email: disattivato, giornaliero o ogni lunedì all’ora scelta.
Regole di avviso: promemoria, limite orario, risoluzione dopo più controlli, privacy e ore di silenzio
Regole di avviso: promemoria, limite orario, risoluzione dopo più controlli, privacy e ore di silenzio

Pausa

Il pulsante Pausa sospende le notifiche per 30 minuti, 2 ore, 8 ore o 24 ore, per esempio durante un aggiornamento. I problemi continuano a essere rilevati e registrati; quelli ancora aperti alla fine della pausa vengono notificati.

Cosa rileva il modulo

Errori PHP

Il modulo cattura gli errori fatali e gli avvertimenti (e, in opzione, notice e deprecation) nel negozio e, se l’opzione è attiva, nel back office. Gli errori identici sono raggruppati. Un nuovo errore fatale genera subito un avviso critico; scade senza messaggio dopo 24 ore senza nuove occorrenze. Un avviso di picco parte oltre 100 errori e avvertimenti in 15 minuti (regolabile, 0 per disattivare). I log di PrestaShop di gravità 3 e 4 vengono importati a ogni esecuzione del cron. Ogni errore riceve un’origine probabile: modulo, tema, override, template compilato o core; quando l’errore nasce nel core, si usa il primo modulo della pila delle chiamate.

Tempo di risposta

Il tempo di risposta è misurato sulle visite reali. La Quota di pagine misurate va dall’1 al 100 %; ogni pagina misurata costa una scrittura nel database. Parte un avviso quando il 95° percentile sui 15 minuti supera la soglia (3000 ms per impostazione predefinita), a partire da 20 pagine misurate, e si risolve quando il p95 torna il 10 % sotto la soglia. Parte un avviso critico quando oltre il 5 % delle richieste finisce in errore del server sui 15 minuti, con almeno 5 errori.

Disponibilità e pagine monitorate

A ogni esecuzione del cron del server, il modulo carica la home page e fino a 5 pagine a tua scelta: una categoria, un prodotto, il carrello, la pagina contatti… Una pagina è online quando risponde HTTP 2xx o 3xx (dopo al massimo 3 reindirizzamenti), 401 o 429. È non raggiungibile quando non risponde, risponde 5xx o un altro 4xx, non contiene il testo atteso che hai impostato o, per la home page, è vuota. Dopo 2 errori di seguito (regolabile) si apre un avviso critico. Il controllo è sospeso in modalità manutenzione.

Controllo di disponibilità: home page con testo atteso e fino a 5 pagine del negozio
Controllo di disponibilità: home page con testo atteso e fino a 5 pagine del negozio

Sono accettati solo indirizzi sui domini del tuo negozio: per questo controllo il modulo non chiama mai un altro sito. Usa Salva e prova le pagine ora per verificarle subito. Se il server non raggiunge il proprio indirizzo pubblico (alcuni hosting, Docker, un proxy), inserisci l’indirizzo locale del server web in Indirizzo di connessione, per esempio 127.0.0.1:80: l’indirizzo della pagina e la sua intestazione Host restano invariati.

Pagamenti e ordini

  • Pagamenti falliti: ordini passati a uno degli stati scelti nell’ultima ora, per modulo di pagamento (soglia 3 per impostazione predefinita). Il controllo parte anche appena un ordine cambia stato, dopo l’invio della risposta: non rallenta mai l’ordine.
  • Conversione del checkout: quota dei carrelli arrivati al passaggio di pagamento e diventati ordini, su una finestra di 2 ore, confrontata con la quota abituale su 28 giorni. Inizia dopo circa 40 carrelli di storico.
  • Calo degli ordini: ordini delle ultime 3 ore (regolabile) confrontati con la stessa fascia oraria delle 4 settimane precedenti. Saltato quando sono attesi meno di 4 ordini.
  • Sensibilità: bassa, media (consigliata) o alta.
Pagamenti e ordini: stati di pagamento fallito, conversione al pagamento e calo degli ordini
Pagamenti e ordini: stati di pagamento fallito, conversione al pagamento e calo degli ordini

Stato del server

  • Certificato SSL: letto ogni 6 ore. Avvertimento 14 giorni prima della scadenza (regolabile), critico a 3 giorni.
  • Spazio su disco: avvertimento sotto 2048 MB liberi (regolabile), critico sotto un quarto di questa soglia.
  • Controllo del cron: dopo il primo cron del server, parte un avviso dopo 30 minuti senza esecuzione.
Salute del server: scadenza del certificato SSL, spazio su disco e controllo del cron
Salute del server: scadenza del certificato SSL, spazio su disco e controllo del cron

Gestire gli avvisi

Un problema apre un solo avviso, aggiornato finché dura. La scheda Avvisi mostra un bilancio su 30 giorni (avvisi, avvisi critici, tempo medio di risoluzione, messaggi inviati), lo storico con la durata di ogni incidente e il registro di ogni invio.

Storico degli avvisi con bilancio su 30 giorni e tempo medio di risoluzione
Storico degli avvisi con bilancio su 30 giorni e tempo medio di risoluzione
  • Prendi in carico: ferma i promemoria. Il messaggio di risoluzione viene comunque inviato.
  • Chiudi: chiude l’avviso. Se il problema persiste, al controllo successivo si apre un nuovo avviso.
Registro delle notifiche inviate via email, Slack e Telegram, con il risultato di ogni invio
Registro delle notifiche inviate via email, Slack e Telegram, con il risultato di ogni invio

Confermare dallo smartphone

Ogni notifica di avviso contiene un link Conferma e ferma i promemoria, firmato per quell’avviso. Apre nel negozio una pagina di conferma pensata per lo smartphone, e l’avviso viene confermato solo dopo la tua conferma: gli antivirus di posta che aprono i link non possono quindi confermarlo al posto tuo.

Pagina di conferma aperta dallo smartphone: interrompere i promemoria senza accedere
Pagina di conferma aperta dallo smartphone: interrompere i promemoria senza accedere

Pagina degli errori PHP

Filtra per gravità o origine e cerca un messaggio, un file o una pagina. Un errore espanso mostra pagina, controller, date, messaggio completo e pila delle chiamate. Copia il report per uno sviluppatore copia un testo con le versioni di PrestaShop e PHP, file, origine, pagina, occorrenze, messaggio e pila delle chiamate. Silenzia continua a contare l’errore ma non lo segnala più.

Registro degli errori PHP: modulo responsabile, stack delle chiamate e report da copiare per uno sviluppatore
Registro degli errori PHP: modulo responsabile, stack delle chiamate e report da copiare per uno sviluppatore

Permessi

Un dipendente il cui profilo ha solo il permesso visualizza su Monitoraggio e avvisi consulta tutte le schermate in sola lettura: i campi sono disattivati e le azioni (avvio, pausa, conferma, impostazioni) vengono rifiutate.

Dati e privacy

  • Gli indirizzi delle pagine sono salvati senza parametri URL, la pila delle chiamate senza argomenti delle funzioni.
  • Il percorso del server e il nome della cartella di amministrazione sono rimossi da ogni testo salvato o inviato.
  • I token dei bot e i percorsi dei webhook sono mascherati nel registro delle notifiche.
  • Lo storico viene eliminato dopo 30 giorni per impostazione predefinita (da 7 a 365 giorni), a piccoli lotti; gli avvisi chiusi sono conservati almeno 90 giorni.

Limiti noti

  • Il controllo di disponibilità parte dal server stesso: non vede un guasto di rete o DNS esterno. L’heartbeat esterno copre questo caso.
  • Un errore fatale avvenuto prima del caricamento dei moduli non è catturato dal gestore degli errori; il controllo di disponibilità e il tasso di 5xx lo segnalano.
  • Le pagine Symfony del back office non passano dall’hook che cattura gli errori del back office.
  • La conversione del checkout si basa sull’hook displayPaymentTop. Se il tuo checkout in una pagina non lo richiama, disattiva questo controllo: il calo degli ordini resta attivo.

Risoluzione dei problemi

La prova email non riesce

Controlla la configurazione in Parametri Avanzati > Email e invia una prova da quella pagina. L’errore esatto compare dopo la prova e nella scheda Avvisi.

La home page risulta non raggiungibile anche se il negozio funziona

Probabilmente il server non raggiunge il proprio indirizzo pubblico. Compila Indirizzo di connessione (per esempio 127.0.0.1:80) e clicca su Salva e prova le pagine ora.

«Nessun cron del server rilevato» resta visualizzato

Contano solo il cron da riga di comando e l’URL del cron. Esegui il comando a mano in SSH: stampa un report JSON. Se fallisce, verifica il percorso di PHP CLI con il tuo hosting.

La prova del webhook risponde «indirizzo rifiutato»

L’URL punta alla rete privata o al server stesso. Usa un indirizzo pubblico oppure attiva Consenti un webhook sulla rete privata se il tuo strumento è ospitato sulla tua rete.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza