Sentry Breadcrumbs: Die Spur vor einem Fehler
Sentry Breadcrumbs
Sentry Breadcrumbs: addBreadcrumb, Filter und Limits | We.Inc
So funktionieren Sentry Breadcrumbs im JavaScript SDK: automatische und manuelle Breadcrumbs, Filtern mit beforeBreadcrumb, der Standardwert 100 für maxBreadcrumbs und das Bereinigen sensibler Daten.
Breadcrumbs in Sentry sind kleine Einträge darüber, was kurz vor einem Fehler passiert ist: Klicks, Netzwerk-Requests, Konsolenmeldungen und Seitenwechsel. Das SDK sammelt viele davon automatisch, eigene ergänzt du mit Sentry.addBreadcrumb(), und sie werden an das nächste Fehler-Event angehängt. Standardmäßig behält das JavaScript SDK die letzten 100.
Breadcrumb-Einstellungen im Überblick
- Einstellung oder Aufruf
- Was sie bewirkt
- Standard
- maxBreadcrumbs
- Wie viele Breadcrumbs behalten werden
- beforeBreadcrumb
- Jeden Breadcrumb vor dem Speichern bearbeiten oder verwerfen
- Nicht gesetzt
- Sentry.addBreadcrumb()
- Einen eigenen Breadcrumb aufzeichnen
- Nicht zutreffend
- fatal, error, warning, log, info oder debug
- Nicht gesetzt
Wenn ein Kunde auf deiner Website auf einen Fehler stößt, sagt dir der Stack Trace, wo der Code abgebrochen ist, aber nicht, was der Kunde vorher getan hat. Breadcrumbs schließen diese Lücke. Dieser Leitfaden behandelt das JavaScript SDK für den Browser; andere Sentry SDKs folgen derselben Idee mit eigenen Standardwerten.
- Das SDK achtet auf Klicks und Tastendrücke, fetch- und XHR-Requests, Konsolenaufrufe und Adresswechsel und macht aus jedem einen Breadcrumb.
- Dein eigener Code kann mit Sentry.addBreadcrumb() weitere hinzufügen, zum Beispiel nach einer Anmeldung oder wenn ein Gutschein eingelöst wurde.
- Jeder neue Breadcrumb läuft zuerst durch beforeBreadcrumb, falls du es gesetzt hast. Gibst du null zurück, wird er verworfen.
- Die behaltene Spur ist auf maxBreadcrumbs begrenzt; das SDK schneidet die ältesten ab, wenn die Liste über die Grenze wächst.
- Wenn ein Fehler erfasst wird, wird die aktuelle Spur an dieses Event angehängt und auf der Issue-Seite angezeigt.
- Nutze eine kurze, gleichbleibende Kategorie wie auth, cart oder payment, damit du die Spur auf der Issue-Seite filtern kannst.
- Leg Details in data ab, nicht in die Nachricht, damit sie als Felder erscheinen.
- Schreib niemals Passwörter, Kartennummern oder vollständige Adressen in einen Breadcrumb. Sentry rät selbst, keine personenbezogenen Daten zu loggen, wenn Konsolenlogs zu Breadcrumbs werden.
- Wenn die Konsole sehr gesprächig ist, verwirf Konsolen-Breadcrumbs in beforeBreadcrumb, statt maxBreadcrumbs für alles zu senken.
- Setzt du maxBreadcrumbs auf 0, sind Breadcrumbs ausgeschaltet; das SDK bricht bei Werten von 0 oder weniger früh ab.
Häufige Fragen
Was ist der Standardwert von maxBreadcrumbs?
100. Die Sentry-Dokumentation nennt für das JavaScript SDK einen Standardwert von 100, und der SDK-Quellcode verwendet dieselbe Zahl, wenn die Option nicht gesetzt ist.
Welche Breadcrumbs werden automatisch aufgezeichnet?
Im Browser-SDK: Klicks und Tastendrücke auf DOM-Elementen, XHR- und fetch-Requests, Aufrufe der Console API und alle Adresswechsel.
Welche Schlüssel kann ein Breadcrumb haben?
type, category, message, level, timestamp und data. Laut Dokumentation werden andere Schlüssel bei der Verarbeitung verworfen.
Wie verhindere ich, dass ein Breadcrumb aufgezeichnet wird?
Setze beforeBreadcrumb in Sentry.init. Es erhält jeden Breadcrumb und einen optionalen Hinweis und kann einen geänderten Breadcrumb oder null zurückgeben, um ihn zu verwerfen.
Werden Breadcrumbs einzeln gesendet?
Nein. Sie werden im Speicher gehalten und an das nächste Event angehängt, das das SDK sendet, etwa einen Fehler.
Manuelle Breadcrumbs, die sich lohnen
- Automatische Breadcrumbs sagen dir, was der Browser getan hat. Manuelle sagen dir, was im Geschäftsablauf passiert ist: Ein Kunde hat Expressversand gewählt, ein Rabattcode wurde eingelöst, ein Buchungsdatum wurde ausgewählt.
- Genau nach diesen Momenten fragt der Support zuerst, wenn du sie aufzeichnest, sparst du dir also eine Runde Rückfragen.
Personenbezogene Daten heraushalten
- Breadcrumbs nehmen oft Text auf, den du gar nicht behalten wolltest: eine E-Mail-Adresse in einer Konsolenzeile, eine Suchanfrage in einer URL. Bereinige sie in beforeBreadcrumb, bevor sie gespeichert werden, und nutze beforeSend für den Rest des Events.
- Sentry bietet außerdem eine serverseitige Datenbereinigung, die du in der Oberfläche konfigurierst und die als zweites Netz dient.
Codebeispiele
Einen manuellen Breadcrumb hinzufügen
Zeichne einen Geschäftsschritt mit Kategorie, kurzer Nachricht, Level und zusätzlichen Feldern unter data auf.
Breadcrumbs filtern und bereinigen
Verwirf Konsolenrauschen, maskiere E-Mail-Adressen und schreib das Standardlimit aus, damit es leicht zu ändern ist.
Simulator für die Breadcrumb-Spur
Zeichne ein paar Events auf, stell die Optionen ein und lös dann einen Fehler aus, um zu sehen, welche Breadcrumbs mitgeschickt würden. Das ist eine Simulation in deinem Browser; nichts wird an Sentry gesendet.
Ein Event aufzeichnen
Klick auf In den Warenkorb
Warenkorb-Request abgeschlossen
console.log-Aufruf
Zur Kasse gehen
Kunde hat sich angemeldet
button#add-to-cart
Warenkorbsumme neu berechnet
Angemeldet als [email protected]
maxBreadcrumbs
Konsolen-Breadcrumbs in beforeBreadcrumb verwerfen
E-Mail-Adressen in Nachrichten ersetzen
Einen Fehler auslösen
Spur leeren
Aktuelle Spur ({n} behalten)
Noch keine Breadcrumbs. Zeichne oben ein Event auf.
{n} ältere Breadcrumbs wurden durch das Limit verworfen.
{n} Breadcrumbs wurden von beforeBreadcrumb entfernt.
An das Fehler-Event angehängte Breadcrumbs
Sentry.init-Optionen für diese Einstellungen
Kostenlos testen · Kostenlos bauen, keine Karte nötig
Verwandt: Ratgeber
- SEO für Auftragnehmer
- SEO für Zahnarztpraxen
- SEO für Anwälte
- SEO für Restaurants
- SEO für Unternehmen mit Einzugsgebiet
- SEO-freundliches Webdesign
- Website-Design für Dienstleistungsunternehmen
- shadcn-Formular und Data Table, sauber verbunden
Produkt
Für wen
- Für Agenturen
- Für Freelancer
- Für Hosting-Anbieter
- Für SaaS-Plattformen
- Für Start-ups
- Finanzdienstleistungen
- Lösungen für das Gesundheitswesen
Funktionen
Ressourcen
- Blog
- Hilfecenter
- Kostenlose Tools für Unternehmen
- Free UI Components
- Vorlagen
- Vorlagen-Sammlungen
- Website-Beispiele
- Ratgeber
- Vergleiche
- Alternativen
- Die besten
- Testberichte
- Preisübersichten
- Anwendungsfälle
- Glossar und Anleitungen
- Integrationen
- Entwickler
- Benchmark
- Windows App