Browser monitoring ist ein Beta-Feature von AppSignal Labs. Das Paket
@appsignal/browser wird unter dem beta-Tag auf npm veröffentlicht, und
seine Konfiguration und API können sich zwischen Beta-Releases noch ändern.
Teilen Sie Ihr Feedback in unserer
Discord-Community.Wie Fehler gruppiert werden
AppSignal gruppiert verwandte Fehler anhand der gemeldeten Route und der Gruppierungseinstellungen Ihrer Anwendung zu Issues. Wiederholte Vorkommen können als ein einzelnes Issue zum Triagieren erscheinen. Die Route ist die, die das SDK übersetRouteTemplate() gemeldet hat, oder der Pfad der Seite, wenn nichts angegeben wurde. Ohne Template sind /orders/1 und /orders/2 unterschiedliche Fehlerrouten. Ein Bug kann so zu zwei Issues werden.
Die Issue-Liste lesen
Jedes Issue in der Liste enthält:- Die Fehlerklasse und die Meldung, mit der Route, auf der der Fehler aufgetreten ist.
- Die Version, in der er eingeführt wurde. Wenn er zuerst in Ihrem neuesten Release auftaucht, prüfen Sie dieses Deploy.
- Einen Trend für den gewählten Zeitraum, sodass sich eine Spitze anders liest als ein gleichmäßiges Tröpfeln.
- Die Gesamtzahl der Vorkommen im Zeitraum.
- Wann er zuletzt gesehen wurde.
- Wem er zugewiesen ist.
Nach Zeit und Version filtern
- Zeitraum. Voreinstellungen von einer Stunde bis 30 Tage oder ein eigener Zeitraum.
- Version. Beschränken Sie die Liste auf die Fehler, die ein einzelnes Release gemeldet hat. Kombiniert mit der Spalte „Eingeführt in” bestätigen Sie damit, ob ein Deploy verantwortlich ist.
Ein Issue untersuchen
Wählen Sie ein Issue in der Liste aus, um es in einem Seitenpanel zu öffnen. Das Panel hat zwei Tabs:- Sample: ein Mal, als der Fehler im Browser eines Nutzers aufgetreten ist.
- Logbook: die Notizen Ihres Teams zum Issue, mit seinen Statusänderungen und verknüpften GitHub-Issues.
- Error message und Tags.
- Den Backtrace, für Fehler, die Ihr Code wirft.
- Trace service map und Trace timeline.
- Zugehörige Log-Zeilen, wenn das Back end instrumentiert ist.
- Breadcrumbs.
- Lesen Sie die Meldung. Sie sagt Ihnen, was fehlgeschlagen ist.
POST https://api.example.com/orders: HTTP 503bedeutet zum Beispiel, dass die Checkout-API einen Serverfehler zurückgegeben hat. - Prüfen Sie den Backtrace auf Fehler, die Ihr Code wirft. Er zeigt, wo der Fehler in Ihrem Code aufgetreten ist. Wenn Sie minifizierten Code statt lesbarer Dateinamen und Zeilen sehen, laden Sie sourcemaps hoch für die in
appVersiongesetzte Version. - Lesen Sie die Breadcrumbs. Sie zeigen Ereignisse vor dem Fehler, etwa eine Button-Auswahl oder einen Netzwerk-Request. Wenn der Nutzer Pay ausgewählt hat, kurz bevor
/ordersdrei Sekunden brauchte, prüfen Sie zuerst diesen API-Request. - Prüfen Sie Version und Tags. Vergleichen Sie die Version des samples mit Ihren letzten Deploys. Nutzen Sie mit
setTags()gesetzte Tags, um einzugrenzen, wer betroffen war.
HTTPError oder TimeoutError gemeldet wird, hat keinen Backtrace. Stattdessen zeigt der Tab Sample seinen Trace. Die Karten Trace service map und Trace timeline zeigen seinen Browser-Span. Ist das Back end instrumentiert, erscheinen seine Spans dort ebenfalls, gefolgt von den zugehörigen Log-Zeilen. Open full trace page, das Symbol neben der Issue-Nummer, öffnet die vollständige Issue-Seite.

Das Seitenpanel für einen fehlgeschlagenen Request: die Services Browser und Django in einem Trace, dann dessen Timeline und zugehörige Log-Zeilen.
Triage und Benachrichtigungen
Sie können diese Issues zuweisen, stummschalten und ihren Status ändern. Sie unterstützen außerdem Benachrichtigungseinstellungen. Mehr dazu unter Errors. Weil Front-end-Fehler imbrowser-namespace liegen, sind diese Einstellungen von Ihren Back-end-Einstellungen getrennt. Wenn Sie von @appsignal/javascript migrieren, richten Sie Benachrichtigungen für browser ein. Einstellungen für frontend werden nicht übernommen. Mehr dazu im Migrationsleitfaden.
Fehler, die Sie hier nicht finden
Manche Fehler erreichen das SDK nie. Dazu gehören Fehler vorinit() und Fehler innerhalb nicht instrumentierter iframes. Undurchsichtige Cross-Origin-Skriptfehler werden verworfen. Für jeden gibt es einen Workaround, aufgeführt unter Fehler, die nicht gemeldet werden. Wenn ein erwarteter Fehler fehlt, arbeiten Sie die Fehlerbehebung durch.