| name | session-replay |
| description | Set up session replay for visual debugging. Use when implementing DOM recording with privacy controls. |
| triggers | ["session replay","record user sessions","visual debugging"] |
| priority | 3 |
Session Replay
Capture visual recordings of user sessions for debugging.
When to Use
- Reproducing hard-to-debug issues
- Understanding user confusion
- QA and support investigations
- Validating error context
Privacy Requirements (Must Do)
Mask by default:
- All text input fields
- Passwords and sensitive data
- Financial information
- Personal identifiers
- User photos/documents
- Chat messages
Performance Budget
| Resource | Limit |
|---|
| CPU | <3% additional |
| Memory | <10MB additional |
| Network | Batch uploads, compress |
| Bundle | Lazy load SDK |
Best Practices
| Do | Don't |
|---|
| Lazy load replay SDK | Include in main bundle |
| Mask all inputs by default | Allow recording of inputs |
| Sample sessions (10-20%) | Record 100% |
| Focus on error sessions | Record everything |
| Test privacy masking | Assume it works |
Sampling Strategy
replaysSessionSampleRate: 0.1 // 10% of sessions
replaysOnErrorSampleRate: 1.0 // 100% of error sessions
Implementation
Load vendor-specific configuration from references/platforms/*.md when generating code.
| Vendor | Config Reference |
|---|
| Sentry | references/platforms/sentry.md |
| Datadog | references/platforms/datadog.md |
| LogRocket | references/platforms/logrocket.md |
| FullStory | references/platforms/fullstory.md |
Related
skills/error-tracking - Correlating errors with replays
skills/user-journey-tracking - Session context