Verify Session Replay capture

Verify Session Replay capture with a test session before you roll out production recording. Check that you can open the replay, associate it with the intended user activity, and apply your privacy settings.

Prerequisites

• Install the SDK or integration for your app.
• Configure session matching.
• Configure privacy settings and any platform-specific masking controls.

Capture a test session

1. Temporarily set the SDK's sampleRate to 1 (100%) to capture all sessions during testing. If you manage sampling through Session Replay settings, set the rate there to 100%. Follow your SDK's testing instructions for local and remote configuration.
2. Use your app to perform a known sequence of actions and send analytics events through the source connected to Session Replay. Record the test user's ID, the session start time, and the actions you perform.
3. Find the test replay using the test user's ID and a date range that includes the session start time. Replays are generally available five minutes after a session begins.
4. Open the replay in the viewer and confirm that it shows the actions you recorded in step 2, in the same order.
5. Check that the replay matches the intended analytics session.
6. Review the content you configured to mask or exclude. Confirm that sensitive content doesn't appear in the recording.
7. After confirming capture, session matching, and masking, lower the sample rate from 1 (100%) to your intended production rate. Update the SDK configuration or Session Replay settings where you changed the rate for testing.

For browser SDK tests, the plugin troubleshooting guide and standalone troubleshooting guide describe capture, focus, and event-association checks.

Diagnose a failed check

If you can't open the replay or it appears incomplete, inspect the Ingestion Monitor. Troubleshoot Session Replay explains common playback and upload symptoms.