Session Replay for Browser RUM
Session Replay allows you to monitor user activity within browser applications by recording interactions such as clicks, scrolls, and navigation. It captures these interactions as dynamic, video-like journeys, along with detailed session metadata. This provides teams with clear insight into the user experience, especially when issues arise. You can watch the session replay to:
- Optimise the user experience.
- Debug the errors for application crashes.
- Diagnose the reasons for application slowness.
セッションリプレイ ライセンス
セッションリプレイは、RUM Peak、Browser RUM-Pro、Browser RUM-Peak、Mobile RUM-Pro、および Mobile RUM-Peak パッケージで利用可能なアドオンライセンスです。詳細については、「セッションリプレイ 」を参照してください。
前提条件
セッションリプレイを使用するには、次の条件が満たされていることを確認してください。
- コントローラ 25.725.10 以降
- javascript エージェント 25.9 以降
JavaScript エージェントの構成
- Configure Session Replay で、Enable Session Replay を選択します。
Configure Session Replay Using API Parameters
After this configuration, copy the instrumentation script and inject it in the JavaScript Agent.
(function(config){
// ... other JSAgent configs
config.sessionReplay = {
enabled: true,
sessionReplayUrlHttps: ""
// ... other optional configs
};
})(window["adrum-config"] || (window["adrum-config"] = {}));enabled
Set this parameter to true to enable Session Replay.
sessionReplayUrlHttps
Ensure to update the controller property eum.blob.service.cloud.host with the correct region-specific Blob Service base URL.
| Region | Base URL |
|---|---|
| PDX | https://blob-service.eum-appdynamics.com/ |
| GRU | https://gru-blob-service.eum-appdynamics.com |
| FRA | https://fra-blob-service.eum-appdynamics.com |
| SYD | https://syd-blob-service.eum-appdynamics.com |
| SIN | https://sin-blob-service.eum-appdynamics.com |
| LON | https://lon-blob-service.eum-appdynamics.com |
| BOM | https://bom-blob-service.eum-appdynamics.com |
(Required)
Type: String
Enter the endpoint where you want to send the captured session data (EUM cloud URL).
packAssets
Type: boolean
packAssets: true | {
fonts?: false
images?: false
styles?: true
}This parameter packs the website assets like images, CSS, and fonts in the recorded.
fonts and images if required.
packAssets: boolean | {
fonts?: boolean
images?: boolean
styles?: boolean
}iframes
Type: boolean
Default: true
Records the same-origin iFrames.
imageBitmap
Type: boolean
Default: false
Enable this option to capture the canvas and video content for richer session replay.
maskAllText
Type: boolean
Default: false
Masks all textual content across the page.
maskAllInputs
Type: boolean
Default: true
Masks all <input> fields to protect user-entered sensitive data.
persistence
Type: boolean
Default:{ enabled: false}
During frequent site refreshes or navigation, Session Replay data may be lost. To prevent this, configure the persistence object to enable local storage persistence for your Session Replay data.
window['adrum-config'] = {
sessionReplay: {
persistence: {
enabled: true
}
}
};sensitivityRules
Type: Array
Fine-tunes element-level privacy masking. Follow the syntax to include sensitivityRules:
sensitivityRules:[{rule:<Type>, selector:<Css Elements>}]There are three rule types that apply to the information within specified CSS object in the recording:
- exclude: Skips the information.
- mask: Masks the information.
- unmask: Unmasks the information.
sensitivityRules: [{ rule: "exclude", selector: "img" },{ rule: "mask", selector: ".sensitive-field" },{ rule: "unmask", selector: ".public-info" }]sessionReplayScriptUrl
Type: string
Overrides the default replay script location.
Generally: adrumExtUrlHttps + "adrum/session-replay/" + agentVersion
enableReplayFolderVersioning
Type: boolean
Uses agent version folders for compatibility. Set to false to serve from a flat structure (e.g., https://your-cdn.com/replay).
セッションリプレイの有効化
- [Session Replay] タブで、[Enable Session Replay] を選択します。
セッションリプレイの表示
- に進みます。
- セッションリプレイを有効にしたアプリケーションを選択します。
- Sessions を選択します。
- 録音が可能な場合、[Session Replay] に再生アイコンが表示されます。
- [Session Replay] タブを展開します。
[Session Replay] は、セッションのアクティブなセグメントを強調表示します。録画またはユーザー アクティビティがない場合は、空白の画面が表示されます。
再生速度を調整できます。