PrestaShop Monitoring & Meldingen (DataFirefly Monitor)
DataFirefly Monitor 2.0.0 installeren op PrestaShop 1.7.8 tot 9, de cron inplannen, meldingskanalen, bewaakte pagina's en regels instellen en elke detectie begrijpen.
DataFirefly Monitor bewaakt uw PrestaShop-winkel continu en waarschuwt u wanneer hij uitvalt, crasht, trager wordt of geen betalingen meer ontvangt. Hij noemt de module die waarschijnlijk de oorzaak is, stuurt één melding per probleem en laat weten wanneer alles weer normaal is. Deze documentatie geldt voor versie 2.0.0.

Installatie en update
Vereisten
- PrestaShop 1.7.8 tot 9.x, multistore en meertalig
- PHP 7.1 tot 8.5, met cURL (aanbevolen)
- Een crontaak elke 5 minuten (aanbevolen, zie hieronder)
Installatie
- Open in de back-office Modules > Modulebeheer, klik op Een module uploaden en stuur
dfmonitor-2.0.0.zip. - De module maakt zijn tabellen en het tabblad Geavanceerde instellingen > Monitoring & meldingen aan. De knop Configureren van de module leidt er direct naartoe.
- Bij de installatie wordt het e-mailadres van de winkel als ontvanger gebruikt en de status Betalingsfout als foutstatus gekozen. PrestaShop-logs van vóór de installatie worden niet geïmporteerd.
Update vanaf 1.x
Upload de nieuwe zip over de oude: het updatescript voegt de nieuwe kolommen en instellingen toe zonder uw gegevens aan te raken. Foutgeschiedenis, meldingen, verzendingen, uw instellingen en uw crontoken blijven bewaard, dus de cron-URL die u al gebruikt blijft werken.
Dashboard
De kop vat de toestand van de winkel samen in één zin: Alles werkt, een waarschuwing of een kritiek probleem. Daaronder de open meldingen met de knoppen Bevestigen en Sluiten, en zes indicatoren: beschikbaarheid over 24 uur, reactietijd over 1 uur (p95), PHP-fouten over 24 uur, mislukte betalingen, bestellingen van vandaag vergeleken met de gebruikelijke activiteit, en de server.
De beschikbaarheidsbalk toont de laatste 24 uur in blokken van 15 minuten. De kaart Bewaakte pagina’s toont de homepage en de extra pagina’s met hun laatste HTTP-status, reactietijd en beschikbaarheid over 24 uur.

Twee grafieken tonen de reactietijd (gemiddelde en p95) en de PHP-fouten per uur over 24 uur, gevolgd door de laatste fouten en de traagste paginatypes.

Crontaak
Fatale fouten en mislukte betalingen worden in realtime gemeld. Al het andere (beschikbaarheid, reactietijd, bestellingen, servergezondheid, rapport) wordt beoordeeld door een geplande taak die elke 5 minuten moet draaien.
Servercron (aanbevolen)
*/5 * * * * php /pad/naar/prestashop/modules/dfmonitor/cron.php
Het exacte commando, met het pad van uw server, staat in Instellingen > Geplande controles met een knop Kopiëren. Voer het uit als de gebruiker van de webserver. cron.php weigert elke oproep die niet van de opdrachtregel komt.
Cron via URL
Staat uw host alleen webcrons toe, roep dan de URL uit hetzelfde tabblad aan vanuit uw hostingpaneel of een dienst zoals cron-job.org. Het token kan ook in de header X-Dfmonitor-Token worden meegestuurd. Zonder het juiste token antwoordt het adres met 403 en onthult het niets. Met het token geeft het antwoord alleen de status, de duur en het aantal open meldingen: geen pad, geen versie, geen foutmelding. Via deze URL draaien de controles hooguit één keer per minuut, en Nieuw token genereren maakt het vorige ongeldig.

Zonder cron
Met PHP-FPM start de optie Terugvaloptie zonder cron de controles vanuit het bezoekersverkeer wanneer er 10 minuten geen cron heeft gedraaid, nadat de pagina is verzonden. De beschikbaarheidscontrole en de heartbeat draaien niet in deze modus. Met Apache mod_php is een cron onmisbaar.
Externe heartbeat
De module kan een volledige serveruitval niet zelf melden. Maak een controle aan bij Healthchecks.io of Better Stack en plak de URL in Heartbeat-URL: die wordt bij elke cronrun aangeroepen en de dienst waarschuwt u wanneer de oproepen stoppen.
Meldingskanalen
Schakel zoveel kanalen in als u wilt in Instellingen > Meldingskanalen. Elk kanaal heeft een minimale ernst (waarschuwing en kritiek, of alleen kritiek) en een knop Opslaan en test verzenden. Het resultaat van de laatste verzending staat onder de kanaalnaam.

Geheimen worden nooit meer getoond. Na het opslaan zijn de Slack- en Discord-webhooks, het Telegram-token, de webhook-URL en het geheim ervan, en de heartbeat-URL verborgen: het veld blijft leeg met een hint zoals https://hooks.slack.com/...7f3a. Laat het leeg om de waarde te behouden, typ een nieuwe om ze te vervangen of klik op Verwijderen.
Vul een of meer ontvangers in, gescheiden door komma’s. De e-mails gebruiken de e-mailconfiguratie van PrestaShop (Geavanceerde instellingen > E-mail). De Taal van de meldingen geldt voor alle kanalen; standaard is dat de taal van de winkel. De e-mails bestaan in het Nederlands, Engels, Frans, Spaans, Duits, Italiaans, Pools en Portugees.

Telegram
- Open in Telegram @BotFather, stuur
/newboten volg de instructies. - Plak het ontvangen token in Bottoken.
- Stuur uw bot een bericht of voeg hem toe aan een groep en klik op Mijn chat detecteren: de chat-ID wordt automatisch ingevuld.
Slack en Discord
Slack: Apps > Incoming Webhooks > Add to Slack, kies het kanaal en kopieer de URL die begint met https://hooks.slack.com/. Discord: Serverinstellingen > Integraties > Webhooks > Nieuwe webhook, daarna Webhook-URL kopiëren.
Webhook
Voor Zapier, Make, n8n, een piketsysteem of uw eigen script. Voor elke nieuwe melding, herinnering en oplossing wordt een JSON-POST verstuurd, met de header X-DataFirefly-Event (open, repeat, resolved, test). De body bevat event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop en sent_at. Met een ondertekeningsgeheim draagt elk verzoek X-DataFirefly-Signature: sha256=…, de HMAC SHA-256 van de ruwe body.
Om veiligheidsredenen worden adressen van het privénetwerk, van de server zelf en van cloudmetadatadiensten geweigerd, en worden doorverwijzingen niet gevolgd. Draait uw tool op uw eigen netwerk, schakel dan Webhook op het privénetwerk toestaan in; adressen van cloudmetadata blijven geweigerd.
Meldingsregels
- Herinnering voor een lopende melding: tijd tussen twee meldingen over hetzelfde probleem (standaard 60 minuten). Een probleem dat verergert, van waarschuwing naar kritiek, wordt meteen gemeld.
- Maximaal aantal meldingen per uur: standaard 20, 0 voor geen limiet. Een melding op meerdere kanalen telt één keer. Een tegengehouden bericht verschijnt als Tegengehouden in het logboek en wordt later verzonden.
- Oplossen na: aantal goede controles op rij voordat een melding wordt gesloten (standaard 2), zodat een waarde die rond een drempel schommelt niet steeds open- en opgelost-berichten stuurt.
- Herstelbericht: er wordt een bericht verstuurd wanneer een gemeld probleem verdwijnt.
- Privacy: e-mailadressen in foutmeldingen worden gemaskeerd in Slack, Telegram, Discord en de webhook (standaard aan).
- Stille uren: binnen de gekozen periode gaan alleen kritieke meldingen uit; waarschuwingen wachten tot het einde van de periode.
- Samenvattend rapport per e-mail: uit, dagelijks of elke maandag op het gekozen uur.

Pauze
De knop Pauzeren zet de meldingen 30 minuten, 2 uur, 8 uur of 24 uur stil, bijvoorbeeld tijdens een update. Problemen worden nog steeds gedetecteerd en opgeslagen; wat aan het einde van de pauze nog open is, wordt gemeld.
Wat de module detecteert
PHP-fouten
De module vangt fatale fouten en waarschuwingen op (optioneel ook notices en deprecations) in de winkel en, als de optie aan staat, in de back-office. Identieke fouten worden gegroepeerd. Een nieuwe fatale fout geeft meteen een kritieke melding; die verloopt stil na 24 uur zonder nieuw optreden. Een piekmelding gaat uit boven 100 fouten en waarschuwingen in 15 minuten (instelbaar, 0 om uit te schakelen). PrestaShop-logs met ernst 3 en 4 worden bij elke cronrun geïmporteerd. Elke fout krijgt een waarschijnlijke oorsprong: module, thema, override, gecompileerde template of core; ontstaat de fout in de core, dan wordt de eerste module uit de aanroepstapel gebruikt.
Reactietijd
De reactietijd wordt gemeten bij echte bezoeken. Het Aandeel gemeten pagina’s loopt van 1 tot 100 %; elke gemeten pagina kost één schrijfactie in de database. Er gaat een melding uit wanneer het 95e percentiel over 15 minuten de drempel overschrijdt (standaard 3000 ms), vanaf 20 gemeten pagina’s, en ze wordt opgelost zodra de p95 weer 10 % onder de drempel ligt. Er gaat een kritieke melding uit wanneer meer dan 5 % van de verzoeken over 15 minuten eindigt in een serverfout, met minstens 5 fouten.
Beschikbaarheid en bewaakte pagina’s
Bij elke servercronrun laadt de module de homepage en tot 5 pagina’s naar keuze: een categorie, een product, de winkelwagen, de contactpagina… Een pagina is online wanneer ze antwoordt met HTTP 2xx of 3xx (na hooguit 3 doorverwijzingen), 401 of 429. Ze is onbereikbaar wanneer ze niet antwoordt, 5xx of een andere 4xx geeft, de door u ingestelde verwachte tekst mist of, bij de homepage, leeg is. Na 2 mislukkingen op rij (instelbaar) opent een kritieke melding. In onderhoudsmodus wordt de controle opgeschort.

Alleen adressen op de domeinen van uw winkel worden geaccepteerd: voor deze controle roept de module nooit een andere site aan. Gebruik Opslaan en de pagina’s nu testen om ze meteen te controleren. Bereikt de server zijn eigen openbare adres niet (sommige hosts, Docker, een proxy), vul dan het lokale adres van de webserver in bij Verbindingsadres, bijvoorbeeld 127.0.0.1:80: het paginaadres en de Host-header blijven hetzelfde.
Betalingen en bestellingen
- Mislukte betalingen: bestellingen die in het afgelopen uur naar een van de gekozen statussen gingen, per betaalmodule (standaarddrempel 3). De controle draait ook zodra een bestelling van status verandert, nadat het antwoord is verzonden: ze vertraagt de bestelling nooit.
- Checkout-conversie: aandeel van de winkelwagens die de betaalstap bereikten en een bestelling werden, over een venster van 2 uur, vergeleken met het gebruikelijke aandeel over 28 dagen. Start na ongeveer 40 winkelwagens geschiedenis.
- Daling van bestellingen: bestellingen van de laatste 3 uur (instelbaar) vergeleken met hetzelfde tijdvak van de 4 voorgaande weken. Overgeslagen wanneer minder dan 4 bestellingen worden verwacht.
- Gevoeligheid: laag, gemiddeld (aanbevolen) of hoog.

Servergezondheid
- SSL-certificaat: elke 6 uur gelezen. Waarschuwing 14 dagen voor het verlopen (instelbaar), kritiek bij 3 dagen.
- Schijfruimte: waarschuwing onder 2048 MB vrij (instelbaar), kritiek onder een kwart van die drempel.
- Cronbewaking: zodra een servercron heeft gedraaid, gaat er na 30 minuten zonder run een melding uit.

Meldingen beheren
Een probleem opent één melding, die wordt bijgewerkt zolang het duurt. Het tabblad Meldingen toont een overzicht over 30 dagen (meldingen, kritieke meldingen, gemiddelde oplostijd, verzonden berichten), de geschiedenis met de duur van elk incident en het logboek van elke verzending.

- Bevestigen: stopt de herinneringen. Het herstelbericht wordt nog steeds verzonden.
- Sluiten: sluit de melding. Is het probleem er nog, dan opent bij de volgende controle een nieuwe melding.

Bevestigen vanaf de telefoon
Elke melding bevat een voor die melding ondertekende link Bevestigen en herinneringen stoppen. Hij opent in de winkel een bevestigingspagina die voor de telefoon is ontworpen, en de melding wordt pas bevestigd nadat u dat doet: virusscanners van e-mail die links openen, kunnen haar dus niet in uw plaats bevestigen.

Pagina PHP-fouten
Filter op ernst of oorsprong en zoek op een bericht, een bestand of een pagina. Een opengeklapte fout toont pagina, controller, datums, volledig bericht en aanroepstapel. Rapport kopiëren voor een ontwikkelaar kopieert een tekst met de versies van PrestaShop en PHP, bestand, oorsprong, pagina, aantal keren, bericht en aanroepstapel. Dempen blijft de fout tellen maar meldt haar nooit meer.

Rechten
Een medewerker wiens profiel op Monitoring & meldingen alleen het recht bekijken heeft, ziet alle schermen alleen-lezen: velden zijn uitgeschakeld en acties (starten, pauze, bevestigen, instellingen) worden geweigerd.
Gegevens en privacy
- Paginaadressen worden opgeslagen zonder URL-parameters, de aanroepstapel zonder functieargumenten.
- Het serverpad en de naam van de beheermap worden uit elke opgeslagen of verzonden tekst verwijderd.
- Bottokens en webhookpaden worden gemaskeerd in het meldingenlogboek.
- De geschiedenis wordt standaard na 30 dagen gewist (7 tot 365 dagen), in kleine porties; gesloten meldingen worden minstens 90 dagen bewaard.
Bekende beperkingen
- De beschikbaarheidscontrole vertrekt vanaf de server zelf: een externe netwerk- of DNS-storing ziet ze niet. De externe heartbeat dekt dat geval.
- Een fatale fout vóór het laden van de modules wordt niet door de foutafhandeling opgevangen; de beschikbaarheidscontrole en het 5xx-percentage melden haar.
- Symfony-pagina’s van de back-office lopen niet via de hook die back-officefouten opvangt.
- De checkout-conversie steunt op de hook
displayPaymentTop. Roept uw one-page checkout die niet aan, schakel deze controle dan uit: de daling van bestellingen blijft actief.
Probleemoplossing
De e-mailtest mislukt
Controleer de configuratie in Geavanceerde instellingen > E-mail en stuur vanaf die pagina een test. De exacte fout verschijnt na de test en in het tabblad Meldingen.
De homepage staat als onbereikbaar terwijl de winkel werkt
De server bereikt waarschijnlijk zijn eigen openbare adres niet. Vul Verbindingsadres in (bijvoorbeeld 127.0.0.1:80) en klik op Opslaan en de pagina’s nu testen.
„Geen servercron gedetecteerd” blijft staan
Alleen de cron via de opdrachtregel en de cron-URL tellen. Voer het commando handmatig uit via SSH: het toont een JSON-rapport. Mislukt het, controleer dan het pad van PHP CLI bij uw host.
De webhooktest antwoordt „adres geweigerd”
De URL wijst naar het privénetwerk of naar de server zelf. Gebruik een openbaar adres, of schakel Webhook op het privénetwerk toestaan in als uw tool op uw eigen netwerk draait.