Session Replays
Session Replays ermöglichen es dir, eine videoähnliche Aufzeichnung dessen anzusehen, was ein Nutzer in seinem Browser vor, während und nach einem Fehler getan hat.
Wie es funktioniert
Das @unseenr/replay SDK nutzt rrweb, um DOM-Mutationen, Mausbewegungen, Klicks, Scrolls und andere Interaktionen aufzuzeichnen. Die Aufzeichnung wird in Segmente aufgeteilt, gzip-komprimiert und in Hetzner S3 (EU) gespeichert.
Datenschutz
- Input-Maskierung: Alle Texteingaben werden standardmäßig maskiert. Nutzer sehen
***statt der tatsächlichen Eingaben. - PII-Scrubbing: E-Mail-Adressen werden automatisch aus Replay-Metadaten entfernt, bevor sie gespeichert werden.
- Replay-Daten werden in Hetzner S3 Buckets in der EU (Nürnberg) gespeichert.
Installation
npm install @unseenr/replay
Replay-Kontingent
Session Replays haben ein separates Kontingent von Error-Events:
| Plan | Replays / Monat |
|---|---|
| Free | 500 |
| Starter | 5.000 |
| Pro | 50.000 |
| Business | 500.000 |
| Scale | 1.000.000 |
| Platform | 5.000.000 |
Wenn das Replay-Kontingent überschritten wird, werden neue Replay-Envelopes stillschweigend verworfen (HTTP 200 wird trotzdem an das SDK zurückgegeben).
Replays ansehen
Navigiere zur Replays-Seite deines Projekts. Jedes Replay zeigt:
- Timeline: Ein Abspiel-Scrubber mit der Session-Dauer
- Besuchte URLs: Seiten, die der Nutzer während der Session aufgerufen hat
- Verknüpfte Fehler: Error-Events, die während dieser Session aufgetreten sind
- User Context: Informationen über den Nutzer (wenn bereitgestellt)
- Umgebung: Der Environment-Tag
- Dauer: Gesamte Session-Länge
- Segmentanzahl: Anzahl der Aufzeichnungssegmente
Fehler mit Replays verknüpfen
Wenn ein Fehler während einer aufgezeichneten Session auftritt, enthält das Error-Event die Replay-ID. In der Issue-Detailansicht kannst du direkt zum Replay an dem genauen Moment springen, als der Fehler aufgetreten ist.