Kowal Sentry-Integration für Magento 2
Magento-Module nach klaren Regeln
Du kaufst das Modul einmalig, ohne Domain-Beschränkungen
Kostenlose Installation und Updates über Composer
Partnerprogramm
Technischer Support für Magento
Klare Lizenzierungsregeln für Magento-Module
Sicherheit des Magento-Modul-Codes
Magento 2 und Sentry in einer konsistenten Implementierung
Im E-Commerce-Umfeld haben die schnelle Fehlererkennung und die Analyse ihrer Ursachen direkten Einfluss auf den Umsatz, die Qualität des Kundenservice und die Stabilität des Shops. Kowal_Sentry wurde als Magento-2-Modul entwickelt, mit dem sich der Shop ohne Eingriffe in Core-Dateien und unter Einhaltung der Plattformarchitektur mit Sentry verbinden lässt.
Das Modul unterstützt das Monitoring der wichtigsten Bereiche des Shop-Betriebs:
- PHP-Backend-Fehler,
- JavaScript-Fehler im Storefront und im Adminbereich,
- Tracing von HTTP- und AJAX-Requests,
- Monitoring des Checkouts und des Bestellprozesses,
- Cron Monitoring und Check-ins an Sentry,
- Monitoring von CLI-Befehlen,
- Release Tracking,
- Source Maps für das Frontend,
- Structured Logs,
- Session Replay und User Feedback in kontrolliertem Umfang.
Damit erhält das technische Team einen zentralen Beobachtungspunkt für die gesamte Magento-2-Anwendung.
Die wichtigsten Vorteile der Implementierung des Magento-2-Sentry-Moduls
Schnellere Fehlererkennung in Magento 2
Kowal_Sentry erfasst Backend- und Frontend-Fehler, sodass Probleme unmittelbar nach ihrem Auftreten sichtbar werden. Dies gilt sowohl für PHP-Exceptions als auch für JavaScript-Fehler, RequireJS-Probleme, nicht behandelte Promise Rejections oder Fehler im Zusammenhang mit dem Checkout.
Bessere Analyse der Shop-Performance
Das Modul unterstützt Performance Tracing für Requests, AJAX-Aufrufe, Crons und CLI-Befehle. So lassen sich langsame Prozesse, Performance-Regressionen und Überlastungspunkte in kritischen Bereichen des Magento-2-Shops erkennen.
Monitoring des Checkouts und der Verkaufsprozesse
Für Onlineshops sind die Bereiche am wichtigsten, die sich direkt auf die Conversion auswirken. Kowal_Sentry unterstützt das Monitoring des Checkouts, der Zahlungs- und Versandartauswahl, von place order sowie von Prozessen im Zusammenhang mit der Bestellung. Das ist besonders wichtig bei der Diagnose von Problemen mit Warenkorb, Zahlungen und Kaufabschluss.
Cron Monitoring und Observability technischer Prozesse
Viele wichtige Magento-2-Prozesse laufen im Hintergrund über Cron. Das Modul ermöglicht das Monitoring des Aufgabenstarts, der Ausführungszeit, des Erfolgs- oder Fehlerstatus sowie das Reporting von Check-ins an Sentry. Dadurch erhalten Sie bessere Kontrolle über Synchronisierungen, Importe, Exporte und Shop-Automatisierungen.
Sichere Integration mit Magento-Daten
Das Modul wurde unter Berücksichtigung des Datenschutzes entwickelt. Es unterstützt die Maskierung von Kundendaten, das Blockieren von Cookies und Autorisierungs-Headern, die Redaktion von Query Params, die Begrenzung des POST Body sowie zusätzliche Sanitization-Regeln für Checkout- und Zahlungsfelder.
Was Kowal_Sentry in Magento 2 überwacht
Monitoring des PHP-Backends
Die Erweiterung unterstützt die vollständige Initialisierung des PHP SDK für:
- Storefront HTTP,
- adminhtml,
- REST und GraphQL,
- Cron,
- CLI,
- eigene Endpoints und Integrationen.
So können Exceptions, Fatal Errors, manuelle Meldungen sowie zusätzlicher technischer oder geschäftlicher Kontext gemeldet werden.
Monitoring des JavaScript-Frontends
Auf Browser-Seite integriert das Modul Magento 2 mit dem Browser SDK von Sentry und unterstützt:
window.onerror,unhandledrejection,- RequireJS-Fehler,
- Breadcrumbs für AJAX,
- Tracing von Ladevorgängen und Interaktionen,
- Checkout Instrumentation,
- Session Replay,
- User Feedback Widget.
Diese Lösung eignet sich sowohl für das klassische Magento-Storefront als auch für Shops mit einer größeren Anzahl individueller Skripte und Widgets.
Monitoring des Magento-2-Checkouts
Der Checkout ist einer der kritischsten Bereiche eines Shops. Kowal_Sentry ermöglicht:
- das Tracking von Checkout-Schritten,
- das Tagging der Zahlungs- und Versandmethode,
- Breadcrumbs für AJAX-Fehler im Checkout,
- das Reporting von Exceptions im Zusammenhang mit place order,
- eine bessere Analyse von Problemen, die die Conversion beeinflussen.
Monitoring von Crons und CLI
Durch die Integration mit im Hintergrund ausgeführten Prozessen hilft das Modul, Probleme zu analysieren, die im Storefront nicht immer sichtbar sind:
- Fehler von Importern,
- fehlgeschlagene Integrationssynchronisierungen,
- lange Ausführungszeiten von Crons,
- Fehler von
bin/magento-Befehlen, - instabile asynchron ausgeführte Aufgaben.
Warum dieses Magento-2-Modul für Sentry produktionsreif vorbereitet ist
Kowal_Sentry ist kein einfacher Wrapper zum Versenden von Exceptions. Es ist eine durchdachte Integrationsschicht, die gemäß den Best Practices von Magento 2 entwickelt wurde.
Das Modul:
- modifiziert keine Core-Dateien,
- nutzt Dependency Injection, Plugins, Observer und Layout XML,
- unterstützt die Konfiguration über den Adminbereich,
- funktioniert in Local-, Dev-, Staging- und Production-Umgebungen,
- unterstützt Multistore,
- ermöglicht die unabhängige Steuerung von Backend und Frontend,
- berücksichtigt Datenschutzrichtlinien und Daten-Sanitization,
- unterstützt Release Strategy und die Vorbereitung für Source Maps.
Das ist wichtig für Teams, die eine Lösung für eine reale Implementierung suchen und nicht nur für Entwicklertests.
Hauptfunktionen des Moduls Kowal_Sentry
Error Monitoring für Magento 2
Das Modul ermöglicht das Reporting von:
- unhandled exceptions,
- fatal errors,
- JavaScript-Fehlern,
- AJAX-Fehlern,
- manuellem
captureExceptionundcaptureMessage, - Ereignissen im Zusammenhang mit Checkout und Bestellungen.
Performance Monitoring Magento 2
Kowal_Sentry unterstützt:
- Tracing von Backend-Requests,
- Tracing von Frontend-Requests,
- Spans für HTTP-Aufrufe und Integrationen,
- Monitoring der Ausführungszeit von Crons,
- Monitoring von CLI-Befehlen,
- Korrelation der Performance mit Release und Environment.
Structured Logs und Observability
Das Modul stellt eine Fassade für Structured Logs bereit, sodass Sentry nicht nur als Fehler-Repository, sondern auch als zentraler Korrelationspunkt für Logs, Traces und Exception Events dienen kann.
Session Replay und User Feedback
Im Frontend-Bereich unterstützt die Lösung eine vorsichtige Implementierung von Session Replay mit Datenmaskierung sowie ein Feedback-Widget für Endnutzer. Dadurch können Fehler in realen Nutzersitzungen besser nachvollzogen werden.
Datensicherheit und Datenschutz
Monitoring-Implementierungen im E-Commerce müssen den Schutz personenbezogener und operativer Daten berücksichtigen. Kowal_Sentry wurde mit Blick auf eine sichere Standardkonfiguration entwickelt.
Das Modul unterstützt standardmäßig:
- Maskierung von Kundendaten,
- Blockieren von Authorization-Headern,
- Blockieren von Cookies,
- Entfernen des POST Body,
- Redaktion von Query Params,
- Maskierung von Checkout-Feldern,
- Maskierung von zahlungsbezogenen Feldern,
- Kontrolle des Datenumfangs, der an Replay übergeben wird.
Dadurch kann die Integration mit Sentry verantwortungsvoller und entsprechend den Anforderungen der Organisation implementiert werden.
Für wen ist das Modul Kowal_Sentry geeignet
Diese Lösung richtet sich an:
- produktiv betriebene Magento-2-Shops,
- Softwarehäuser, die Magento-Shops betreuen,
- DevOps-Teams sowie Backend-/Frontend-Developer,
- Unternehmen, die Observability im E-Commerce einführen,
- Organisationen, die mehr Kontrolle über Checkout-Fehler, Integrationen und Performance benötigen.
Das Modul eignet sich sowohl für einen einzelnen Shop als auch für Multistore-Installationen mit komplexeren Geschäftsprozessen.
Zusammenfassung
Kowal_Sentry ist ein umfangreiches Magento-2-Modul zur Integration mit Sentry, das Error Tracking, Performance Monitoring, Cron Monitoring, Checkout Observability und sichere Daten-Sanitization kombiniert. Es ist eine Lösung für Unternehmen, die die Stabilität ihres Shops erhöhen, Probleme schneller diagnostizieren und die Qualität des Betriebs von Magento 2 in der Produktionsumgebung besser kontrollieren möchten.
Wenn Sie ein Modul für Magento 2 Sentry integration, Magento 2 Fehler-Monitoring, Performance Monitoring Magento oder Checkout Monitoring Magento 2 suchen, ist Kowal_Sentry eine Lösung, die genau für dieses Szenario entwickelt wurde.
Kowal_Sentry: Installations- und Konfigurationsanleitung
Zweck des Moduls
Kowal_Sentry integriert Magento 2 mit Sentry und ermöglicht das Monitoring von:
- PHP-Backend-Fehlern,
- JavaScript-Fehlern im Storefront und optional im Adminbereich,
- HTTP-, CLI- und Cron-Transaktionen,
- Checkout Breadcrumbs,
- Session Replay,
- User Feedback,
- Release Tracking und Vorbereitung für Source Maps.
Das Modul wurde als Composer-Paket vorbereitet und sollte aus dem Verzeichnis vendor/kowal/module-sentry heraus funktionieren.
Anforderungen
- Magento Open Source / Adobe Commerce 2.4.x
- PHP 8.1+
- Zugriff auf Sentry und mindestens ein Projekt
- GitHub-Token, wenn das Repository über ein privates
vcsinstalliert wird
Installation
Die folgenden Befehle wurden aus README.md kopiert.
composer config repositories.sentry vcs https://github.com/kowalco/sentrycomposer config --global --auth github-oauth.github.com composer require kowal/module-sentrybin/magento module:enable Kowal_Sentrybin/magento setup:upgradebin/magento cache:flush Wichtig
- Das Composer-Paket soll ausschließlich aus
vendor/kowal/module-sentryfunktionieren. - Dasselbe Modul sollte nicht gleichzeitig in
app/code/Kowal/Sentryliegen. - Nach der Installation finden Sie die Konfiguration unter:
Stores -> Configuration -> Kowal -> Sentry
Schnellstart
Minimale Konfiguration, die zum Starten des Moduls erforderlich ist:
- Setzen Sie
Enable Module = Yes. - Setzen Sie
Environment, z. B.productionoderstaging. - Aktivieren Sie
Enable Backend Monitoringund fügen SieBackend DSNein. - Wenn Sie das Frontend überwachen möchten, aktivieren Sie
Enable Frontend Monitoringund fügen SieFrontend DSNein. - Speichern Sie die Konfiguration und leeren Sie den Cache, falls dies in der jeweiligen Umgebung erforderlich ist.
Woher Sie die Daten aus Sentry erhalten
DSN
Die DSN finden Sie üblicherweise hier:
Settings -> Projects -> [projekt] -> Client Keys (DSN)
In die Felder Backend DSN und Frontend DSN fügen Sie nur die reine DSN-URL ein, z. B.:
https://examplePublicKey@o0000000000000000.ingest.de.sentry.io/0000000000000000Fügen Sie nicht das gesamte Snippet ein:
Sentryinit([ 'dsn' => 'https://examplePublicKey@o0000000000000000.ingest.de.sentry.io/0000000000000000',]);Organization
Den Organisations-Slug können Sie am einfachsten aus der URL des Sentry-Panels ablesen, z. B.:
https://sentry.io/settings/acme/projects/shop-frontend/
In diesem Beispiel:
acmeistOrganizationshop-frontendistProject Slug
Project Slug
Sie können ihn ablesen:
- aus der Projekt-URL im Sentry-Panel,
- oder unter
Settings -> Projects -> [projekt] -> Details
Auth Token für Source Maps
Wenn Sie sentry-cli verwenden, bewahren Sie den Token am besten außerhalb von Magento auf, z. B. in einer Umgebungsvariable:
SENTRY_AUTH_TOKEN
Token-Erstellung:
Settings -> Custom Integrations- oder
User Settings -> Personal Tokens
Verifizierung nach der Installation
Nach der Grundkonfiguration können Sie prüfen, ob das Modul aktiv ist und ob das SDK funktioniert. Die folgenden Smoke-Test-Befehle wurden aus README.md kopiert.
Nach Aktivierung von Enable Test Commands:
bin/magento kowal:sentry:test:errorbin/magento kowal:sentry:test:transactionbin/magento kowal:sentry:test:checkinbin/magento kowal:sentry:test:logKonfiguration im Magento-Panel
Pfad:
Stores -> Configuration -> Kowal -> Sentry
Nachfolgend finden Sie eine Beschreibung der einzelnen Sektionen, Möglichkeiten und Einstellungsvarianten.
Sektion General
Diese Sektion steuert die Aktivierung des Moduls, die Umgebung und die Berechnung von release.
Enable Module
Yes: startet das Modul global.No: Backend und Frontend werden nicht initialisiert, auch wenn andere Optionen aktiviert sind.
Empfehlung:
Yesin der Umgebung, aus der Sie Daten an Sentry senden möchten.
Environment
Beispiele:
productionstagingdevelopment
Varianten:
- ein gemeinsamer Name für die gesamte Instanz,
- unterschiedliche Werte pro Website/Store View, wenn Sie Events trennen möchten.
Empfehlung:
- ohne Leerzeichen und ohne Schrägstriche,
- verwenden Sie eine konsistente Benennung zwischen Backend, Frontend und CI/CD.
Release Strategy
Verfügbare Varianten:
manual: release stammt aus dem FeldRelease Name Overrideenv: release wird aus Umgebungsvariablen abgerufenfile: release wird aus einer Datei gelesengenerated: release wird automatisch durch das Modul zusammengesetzt
Wann verwenden:
manual: wenn Sie release manuell eintragen möchten, eher für Notfälle oder einfache Implementierungenenv: ideal in CI/CD, wenn release durch das Deployment übergeben wirdfile: geeignet, wenn das Deployment den Versionsidentifikator in eine gemeinsam genutzte Datei schreibtgenerated: gut für den Einstieg, wenn Sie noch keine ausgereifte Release-Pipeline haben
Unterstützte Umgebungsvariablen:
KOWAL_SENTRY_RELEASESENTRY_RELEASERELEASE_NAMEGIT_COMMIT
Release Name Override
Wird nur bei der Strategie manual verwendet.
Beispiel:
magento-store@2.4.7-p1+20260410.1
Empfehlung:
- genau derselbe Wert sollte beim Upload der Source Maps verwendet werden.
Project Name
Hilfsname des Projekts in den Kontexten des Moduls. Dies ist nicht der Project Slug aus Sentry.
Varianten:
- Name der Shop-Instanz,
- Name der Shop-Gruppe,
- Name des internen Projekts.
Debug Mode
Yes: ausführlichere Diagnose-ProtokollierungNo: Produktionsmodus
Empfehlung:
Noin der Produktion,Yesvorübergehend, wenn Sie die Konfiguration diagnostizieren.
Enable Test Commands
Yes: stellt Testbefehlebin/magentobereitNo: blendet sie im normalen Betrieb aus
Empfehlung:
Yesauf Staging oder für die Dauer von Tests,Noin der dauerhaften Produktionskonfiguration.
Sektion Backend SDK
Betrifft das PHP SDK, das von Storefront HTTP, Admin, API, Cron und CLI verwendet wird.
Enable Backend Monitoring
Yes: aktiviert das Backend-MonitoringNo: das Backend sendet keine Fehler und Traces an Sentry
Backend DSN
Dies ist die grundlegende DSN für das PHP SDK.
Varianten:
- separates Sentry-Projekt nur für das Backend
- dasselbe Projekt für Backend und Frontend
Empfehlung:
- bei ausgereifteren Implementierungen separate Backend- und Frontend-Projekte verwenden,
- bei kleineren Installationen kann mit einem gemeinsamen Projekt begonnen werden.
Error Sample Rate
Bereich: 0-1
Beispiele:
1: alle Fehler senden0.5: etwa die Hälfte senden0.25: etwa 25% senden
Empfehlung:
- üblicherweise
1.0für Fehler, zumindest zu Beginn.
Trace Sample Rate
Bereich: 0-1
Beispiele:
0.05: niedriges Sampling, gut für Produktion mit hohem Traffic0.1: sinnvoller Startpunkt0.2: mehr Daten auf Kosten des Volumens
Empfehlung:
- in der Produktion üblicherweise
0.05-0.2, abhängig von Traffic und Sentry-Plan.
Profile Sample Rate
Bereich: 0-1
Varianten:
0: Profiling deaktiviert- niedriger Wert, z. B.
0.01: regelmäßige Performance-Diagnose
Empfehlung:
0oder sehr niedriger Wert in der Produktion.
Enable Logs
Yes: sendet Structured LogsNo: keine Logs in Sentry
Wann aktivieren:
- wenn Sie Logs mit Traces und Errors korrelieren möchten.
Enable Metrics API
Yes: aktiviert die Modulfassade für MetrikenNo: Metriken auf Modulseite sind nicht aktiv
Hinweis:
- das aktuelle
sentry/sentry 4.24.xbehandelt Backend Metrics als auslaufende API /no-op.
Enable Cron Monitoring
Yes: sendet Check-ins und Cron-TransaktionenNo: Crons werden nicht durch Sentry überwacht
Die Daten finden Sie in Sentry in der Sektion:
CronsMonitors
Enable CLI Monitoring
Yes: überwachtbin/magento-BefehleNo: kein Monitoring von CLI-Prozessen
Nützlich für:
- Importe,
- Reindexierung,
- individuelle Integrationsbefehle.
Enable Adminhtml Monitoring
Yes: überwacht Requests des AdminbereichsNo: beschränkt das Backend auf Storefront, API, Cron und CLI
Enable API Monitoring
Yes: überwacht REST, GraphQL und andere EndpointsNo: trennt den Integrationsteil vom Monitoring
Sektion Frontend SDK
Betrifft das Browser SDK, das im Storefront und optional im Admin-Panel geladen wird.
Enable Frontend Monitoring
Yes: lädt das Browser SDKNo: das Frontend sendet keine Daten an Sentry
Frontend DSN
Varianten:
- separates Frontend-Projekt
- dieselbe DSN wie Backend
- leeres Feld, damit das Modul den Fallback auf
Backend DSNversucht
Empfehlung:
- zielgerichtet ein separates Frontend-Projekt, wenn Sie übersichtliche Issues, Replay und Performance wünschen.
Enable Storefront JS
Yes: Browser SDK läuft im StorefrontNo: kein SDK im öffentlichen Shop-Bereich
Enable Admin JS
Yes: Browser SDK läuft auch im AdminbereichNo: JS-Monitoring ist auf das Storefront beschränkt
Empfehlung:
- nur aktivieren, wenn Sie tatsächlich JS-Probleme im Adminbereich diagnostizieren.
JS Trace Sample Rate
Bereich: 0-1
Beispiele:
0.01: sehr vorsichtig0.05: guter Start für die Produktion0.1: mehr Daten, größeres Volumen
JS Replay Session Sample Rate
Bereich: 0-1
Beispiele:
0: keine vollständigen Replays0.01: sicherer Start0.05: mehr Daten für UX- und Fehleranalyse
JS Replay On Error Sample Rate
Bereich: 0-1
Beispiele:
1: Replay nach jedem Fehler in der Sitzung0.5: Replay nach einem Teil der Fehler
Empfehlung:
- oft ein besserer Start als ein hohes Sampling aller Sitzungen.
Enable Session Replay
Yes: aktiviert ReplayNo: keine Sitzungsaufzeichnung
Empfehlung:
- zusammen mit starker Maskierung von Checkout und Zahlung aktivieren.
Enable User Feedback Widget
Yes: das Feedback-Widget ist verfügbarNo: das Widget wird nicht geladen
Hinweis:
- je nach Sentry-Plan und -Konto kann die Funktion als Beta / Experimental gekennzeichnet sein.
Enable Checkout Instrumentation
Yes: fügt Checkout-Breadcrumbs und -Tags hinzuNo: kein zusätzlicher Checkout-Kontext
Empfehlung:
- in der Regel lohnt es sich, diese Option aktiviert zu lassen.
Enable Ajax Instrumentation
Yes: Breadcrumbs für AJAX / fetch / XHRNo: weniger Kontext für Frontend-Probleme
Browser SDK CDN URL
Standardmäßig verweist sie auf das offizielle Sentry-Bundle.
Varianten:
- Standard-URL des Moduls
- eigener CDN-Mirror
- festgelegtes konkretes Bundle / konkrete Version
Nur ändern, wenn:
- Sie die SDK-Version pinnen,
- Sie eigene CSP-Regeln haben,
- Sie Asset-Mirroring verwenden.
Sektion Privacy / Security
Diese Sektion ist für die Minimierung des Risikos der Übertragung sensibler Daten verantwortlich.
Send Default PII
Yes: SDK kann den Standardumfang von Benutzer- und Request-Daten sendenNo: konservativere Datenschutzpolitik
Empfehlung:
- in der Regel
No.
Anonymize IP
Yes: vollständige IP nicht übertragenNo: Standardverhalten beibehalten
Empfehlung:
- üblicherweise
Yes.
Mask Customer Data
Yes: maskiert KundendatenNo: geringerer Datenschutz
Empfehlung:
- praktisch immer
Yesin der Produktion.
Mask Checkout Fields
Yes: maskiert Checkout-FelderNo: Risiko eines Datenlecks aus dem Checkout
Empfehlung:
- immer
Yes.
Mask Payment Fields
Yes: maskiert zahlungsbezogene FelderNo: sehr riskant
Empfehlung:
- immer
Yes.
Block Authorization Headers
Yes: entfernt oder maskiertAuthorizationund TokensNo: Risiko der Übertragung von Authentifizierungsdaten
Empfehlung:
- immer
Yes.
Block Cookies
Yes: entfernt Cookies aus den Event-DatenNo: höheres Risiko eines Lecks von Sitzungsdaten
Empfehlung:
- üblicherweise
Yes.
Block POST Bodies
Yes: entferntPOST-BodiesNo: sendet mehr Request-Daten
Empfehlung:
- üblicherweise
Yes, besonders für Checkout, Login und Formulare.
Redact Query Params
Yes: maskiert Query-String-ParameterNo: Query String bleibt besser lesbar, aber weniger sicher
Additional Redacted Keys
Textfeld für zusätzliche Schlüssel zur Redaktion.
Beispiele:
tokenapi_keycustomer_emailexternal_customer_id
Sie können trennen mit:
- Kommas,
- Leerzeichen,
- neuen Zeilen.
Replay Mask Selectors
CSS-Selektoren, deren Inhalt in Replay maskiert werden soll.
Beispiele:
.customer-email.field[name*='password'].payment-method
Replay Block Selectors
CSS-Selektoren, die in Replay vollständig blockiert werden sollen.
Beispiele:
.checkout-container.payment-method iframe.opc-wrapper
Allowed Domains for Replay Network Details
Liste der Domains, für die Replay Details zu Netzwerk-Requests anhängen darf.
Beispiele:
store.example.comapi.example.comtrusted-partner.example
Empfehlung:
- tragen Sie nur eigene und vertrauenswürdige Domains ein.
Sektion Filtering
Diese Sektion reduziert Rauschen und Ereignisvolumen.
Ignore Exceptions Regex
Eine Regex-Regel pro Zeile.
Anwendungsbeispiele:
- bekannte, unkritische technische Fehler,
- Exceptions aus externen Integrationen, die bereits anderweitig behandelt werden.
Ignore URLs Regex
Eine Regex-Regel pro Zeile.
Beispiele:
- Health-Check-Endpoints,
- Test-Webhooks,
- technische Ressourcen.
Ignore Transactions
Ein Transaktionsname pro Zeile.
Empfehlung:
- sammeln Sie zuerst Daten,
- filtern Sie danach wenig wertvolle und wiederkehrende Transaktionen heraus.
Ignore Bots
Yes: schließt Bot- und Crawler-Traffic ausNo: Sie überwachen auch automatisierten Traffic
Empfehlung:
Yesbei hohem SEO-Traffic.
Ignore Health Checks
Yes: überspringt/health,/status,/pingund ÄhnlichesNo: solche Requests werden an Sentry gesendet
Ignore Admin Routes
Yes: reduziert Ereignisse aus dem AdminbereichNo: der Adminbereich bleibt überwacht
Ignore Static Resource Errors
Yes: filtert einen Teil der Asset-Fehler.jsund.cssNo: alle Fehler dieses Typs bleiben sichtbar
Empfehlung:
- üblicherweise
Yes, wenn Sie das Projekt nach Deployments nicht mit Rauschen füllen möchten.
Sektion Context
Steuert die Menge des geschäftlichen Kontexts, der Events hinzugefügt wird.
Attach Store Context
Yes: fügtstore_id,store_code, Shop-Namen und Währung hinzuNo: kein dieser Kontext
Empfehlung:
Yes, insbesondere bei Multistore.
Attach Website Context
Yes: fügt Website-Daten hinzuNo: keine Identifikation auf dieser Ebene
Attach Customer Context
Yes: fügt anonymisierten Kundenkontext hinzuNo: keine Daten zum Kundenstatus
Attach Quote Context
Yes: fügt Warenkorb-/Quote-Kontext hinzuNo: weniger Daten für die Checkout-Diagnose
Attach Cart Totals
Yes: fügt Warenkorb-Totals hinzuNo: leichteres Event
Empfehlung:
- nur aktivieren, wenn diese Daten tatsächlich bei der Analyse helfen.
Attach Order Context
Yes: fügt Bestellkontext hinzuNo: keine Daten zum Order Flow
Besonders nützlich für:
- invoice,
- shipment,
- transaktionale E-Mails,
- ERP-/OMS-Integrationen.
Attach Product Context
Yes: fügt grundlegenden Produktkontext hinzuNo: kein dieser Kontext
Attach Category Context
Yes: fügt grundlegenden Kategoriekontext hinzuNo: kein dieser Kontext
Attach Payment / Shipping Method
Yes: fügtpayment_methodundshipping_methodhinzuNo: weniger Daten für den Checkout
Empfehlung:
- dies ist eine der wertvolleren Diagnoseeinstellungen.
Attach Module Version
Yes: fügt die Version vonKowal_SentryhinzuNo: ohne diese Information in Events
Attach Magento Version
Yes: fügt die Magento-Version hinzuNo: ohne Plattformkontext
Attach Deployment Metadata
Yes: fügt zusätzliche Deployment-Daten hinzu, sofern verfügbarNo: keine dieser Metadaten
Nützlich, wenn Sie ein Problem schnell mit einem Rollout oder einem konkreten Build verknüpfen möchten.
Sektion Source Maps / Release
Diese Sektion organisiert die für Release und Source Maps benötigten Parameter. Der eigentliche Upload sollte in CI/CD erfolgen, nicht während der Magento-Runtime.
Enable Source Map Upload
Yes: bestätigt, dass Sie organisatorisch Source Maps verwendenNo: das Modul setzt keine Source Maps in der Konfiguration voraus
Hinweis:
- dies ist ein Konfigurationsflag, kein Upload-Mechanismus.
Source Map Upload Mode
Varianten:
manual: manuellesentry-cli-Befehleci: Upload in der CI/CD-Pipelinedeploy_hook: Upload im Deployment-Hook
Empfehlung:
- in der Produktion meistens
ci.
Assets Base URL
Beispiel:
https://store.example.com/static/frontend
Dieser Wert muss dem entsprechen, was das Browser SDK im Stack Trace sieht. Andernfalls werden Source Maps nicht zugeordnet.
Release Dist
Optionales dist für release.
Beispiele:
storefrontadminpl-store
Verwenden Sie es, wenn ein Release mehrere Asset-Varianten hat.
Organization
Organisations-Slug, der von sentry-cli und API verwendet wird.
So finden Sie ihn:
- aus der URL des Sentry-Panels,
- z. B.
https://sentry.io/settings/acme/projects/shop-frontend/->acme
Project Slug
Projekt-Slug, der vom Release- und Source-Maps-Workflow verwendet wird.
So finden Sie ihn:
- aus der Projekt-URL,
- oder
Settings -> Projects -> [projekt] -> Details
Release File Path
Pfad zur Datei mit dem Release-Namen bei der Strategie file.
Beispiele:
/var/www/shared/release.txtpub/media/deploy/release-id.txt
Sektion User Feedback
Konfiguration des Widgets für Problemmeldungen auf Browser-Seite.
Widget Theme
Varianten:
lightdarksystem
Empfehlung:
- üblicherweise
system.
Widget Language
Beispiele:
pl-PLen-US
Empfehlung:
- bei Multistore an die Locale der Store View anpassen.
Auto-open after selected errors
Yes: nach ausgewählten Frontend-Fehlern kann ein Feedback-Vorschlag erscheinenNo: das Widget öffnet sich nicht automatisch
Empfehlung:
- vorsichtig einsetzen, um für den Nutzer nicht zu aggressiv zu wirken.
Show on checkout success
Yes: der Feedback-Trigger kann auf der Bestellerfolgsseite erscheinenNo: kein Trigger an dieser Stelle
Show on contact page
Yes: Trigger oder Widget auf der KontaktseiteNo: keine Anzeige auf der contact page
Show in footer
Yes: dauerhaft sichtbarer Trigger im Footer oder als festes SeitenelementNo: kein dauerhafter Trigger
Dies ist die einfachste Option, wenn Sie eine Schaltfläche Zglos problem haben möchten.
Custom Trigger Selector
CSS-Selektor eines vorhandenen Elements, das Feedback öffnet.
Beispiele:
#report-issue.js-sentry-feedback
Verwenden Sie dieses Feld, wenn Sie das Widget an eine eigene Schaltfläche im Layout oder CMS-Block anbinden möchten.
Sektion Cron Monitoring
Diese Sektion steuert Check-ins und Monitore für Magento-Crons.
Enable auto-registration of configured cron jobs
Yes: der erste Check-in kann einen Monitor in Sentry erstellen oder aktualisierenNo: das Modul sendet Check-ins ohne automatische Monitorkonfiguration
Empfehlung:
Yes, wenn Sie ein kontrolliertes Deployment und bewusst definierte Jobs haben.
Monitored job codes
Liste der Magento-job_code.
Sie können trennen mit:
- Kommas,
- Leerzeichen,
- neuen Zeilen.
Varianten:
- leeres Feld: alle Crons überwachen
- Liste ausgewählter
job_code: nur kritische Aufgaben überwachen
Beispiele:
sales_clean_quotescatalog_product_alertindexer_reindex_all_invalid
Timeout threshold per job
Eine Regel pro Zeile:
job_code:minutes
Beispiel:
catalog_product_alert:10
Verwenden Sie dies, wenn ein Cron unregelmäßig ausgeführt wird und Sie Fehlalarme reduzieren möchten.
Max runtime per job
Eine Regel pro Zeile:
job_code:minutes
Beispiel:
indexer_reindex_all_invalid:30
Nach Überschreitung des Limits kann Sentry den Monitor als problematisch markieren.
Check-in slug prefix
Beispiel:
magento-
Nützlich, wenn eine Sentry-Organisation mehrere Magento-Instanzen überwacht und Sie Namenskollisionen vermeiden möchten.
Empfohlene Konfigurationsprofile
Sicherer Produktionsstart
Enable Module = YesEnable Backend Monitoring = YesEnable Frontend Monitoring = YesError Sample Rate = 1Trace Sample Rate = 0.05oder0.1JS Trace Sample Rate = 0.01oder0.05Enable Session Replay = YesJS Replay Session Sample Rate = 0.01JS Replay On Error Sample Rate = 1Send Default PII = NoAnonymize IP = YesMask Customer Data = YesMask Checkout Fields = YesMask Payment Fields = YesBlock Authorization Headers = YesBlock Cookies = YesBlock POST Bodies = YesRedact Query Params = YesIgnore Bots = YesIgnore Health Checks = Yes
Diagnoseprofil für Staging
- höhere
Trace Sample Rate, z. B.0.2 - höhere
JS Trace Sample Rate, z. B.0.1 - vorübergehend
Debug Mode = Yes Enable Test Commands = Yes- vorsichtig mit Replay: Maskierung und Blockierungen weiterhin beibehalten
Minimale Variante nur Backend
Enable Backend Monitoring = YesBackend DSNausgefülltEnable Frontend Monitoring = No
Das ist ein guter erster Schritt, wenn Sie zunächst das Monitoring von Exceptions und Crons auf PHP-Seite starten möchten.
Häufigste Konfigurationsfehler
- Einfügen des gesamten Snippets
Sentryinit(...)statt nur der DSN. - Gleichzeitige Präsenz des Moduls in
vendor/undapp/code/. - Unterschiedliche
release-Werte zwischen Events und Source Maps. - Zu aggressives Replay Sampling in der Produktion.
- Deaktivierung der Maskierung von Checkout und Zahlungen.
- Belassen einer Beispiel-DSN in der aktiven Konfiguration.
Zusammenfassung
Am sichersten ist es, mit Backend-Monitoring, vorsichtigem Frontend-Monitoring und restriktiven Datenschutzeinstellungen zu beginnen. Wenn die Daten in Sentry stabil und übersichtlich werden, können Trace Sampling, Replay und der Umfang des geschäftlichen Kontexts schrittweise erhöht werden.















