Upgrade Session Replay data capturing
- Latest Dynatrace
- How-to guide
- 2-min read
- Published Nov 03, 2026
Session Replay records sessions through the same components as RUM: the RUM JavaScript and OneAgent for Mobile. To upgrade data capturing, update them and then turn on Session Replay for your frontends. The steps below walk you through these tasks.
Update the RUM JavaScript and OneAgent for Mobile
Update the RUM JavaScript and the OneAgent for Android and iOS that monitor your frontends. For the minimum versions and the update steps, see the guide for your frontend: web, Android, or iOS.
To achieve upgrade readiness for Latest Dynatrace, update to:
- RUM JavaScript version 1.347+
- OneAgent for Android version 8.347+
- OneAgent for iOS version 8.347+
For mobile apps, Session Replay also requires a supported platform:
- Android: Android 6.0+ (API level 23+), Android Gradle plugin 8.1.1+, and Kotlin 2.1.0+
- iOS: iOS 15+, Swift 5+, and Xcode 16+
Turn on Session Replay
Turn on Session Replay for each frontend that you want to upgrade. Session Replay Classic stays turned on while you do this.
- Go to
Experience Vitals > Overview. - Select Web or Mobile, and then select the frontend you want to configure.
- Switch to the Settings tab.
- In Enablement and cost control, select Session Replay. Session Replay Classic is already selected from your existing setup, so leave it as it is.
- Check Capture rate of session replay. The capture rate applies to both Session Replay Classic and Session Replay, so you don't need to change it.
- For mobile frontends, to capture all sessions with a crash regardless of the capture rate, select Session Replay for crashes. Leave Session Replay for crashes Classic as it is.
- Select Save.
To update the Session Replay settings of many frontends at scale, use configuration as code.
Review your recording and privacy settings
Your recording and privacy settings work the same way as in Session Replay Classic, so you don't have to change anything. Still, review them to make sure that they record what you want:
- Opt-in mode: If you use opt-in mode for web frontends, your application calls
dtrum.enableSessionReplay()to start recording. For details, see Configure opt-in mode. - URL exclusion: Review the pages and views that you exclude from recording. For details, see Configure URL exclusion.
- Masking: Review your masking rules for recording and playback. For details, see Configure masking. For mobile frontends, see also the masking sections for Android and iOS.
- Resource capture: For web frontends, make sure that Enable resource capture is on so that stylesheets are captured and sessions replay correctly. Resource capture is on by default. For details, see Configure resource capture.
Ready for more?
Once you have completed all steps for upgrading Session Replay data capturing, continue with upgrading your permissions and segmentation configuration.