Session Replay for Browser RUM

Session Replay allows you to monitor user activity within mobile 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.
Attention: This documentation mentions a product that is currently only available as an early preview ("Beta"). Splunk AppDynamics reserves the right to change the Beta and its documentation including the content herein, at any time, for any reason, and without notice or compensation to you before making it generally available as well as never making it generally available. This documentation is not a guarantee of future product features and should not be relied upon in making any purchasing decisions. Actual product results may vary from forward-looking statements due to factors including but not limited to: changes in Splunk AppDynamics and third-party technologies, factors related to the economy and target markets, acquisitions of other companies, the hiring and termination of personnel, and other factors. Please refer to the full terms at https://www.splunk.com/en_us/legal/appdynamics-limited-license-agreement.html for details.

Prerequisites

Ensure that the following conditions are met to use Session Replay:

  • Controller >= 25.3
  • JavaScript Agent = 25.5

JavaScript エージェントの構成

javascript アプリケーションでのセッションリプレイを報告するには、次のように javascript エージェントを構成します。
  1. コントローラ UI にログインします。
  2. 対象のブラウザアプリケーションを開きます。
  3. 左のナビゲーションメニューで、[Configuration] を選択します。
  4. [Configure JavaScript Agent] を選択します。
  5. [Configure Session Replay] で、[Enable Session Replay] を選択します。
    configure-session-replay-JavaScript-agent

API パラメータを使用したセッションリプレイの設定

この設定後、インストルメンテーションスクリプトをコピーして javascript エージェントに挿入します。

JSON
(function(config){
    // ... other JSAgent configs
  
    config.sessionReplay = {
        enabled: true,
        sessionReplayUrlHttps: ""
        // ... other optional configs
    };
})(window["adrum-config"] || (window["adrum-config"] = {}));
オプション タイプ デフォルト 説明
enabled boolean

sessionReplayUrlHttps string (必須)キャプチャされたセッションデータを送信する端末(EUM クラウドの URL)。
packAssets boolean 正しい

記録された画像、 CSS、フォントなどの Web サイトアセットをパックします。このオプションが無効化されている場合、再生時にアセットを取得するアセット URL のみ記録に保持されます。

iframe boolean true 同一の送信元の iframe を記録します。
imageB itmap boolean false キャンバスとビデオコンテンツをキャプチャしてセッションリプレイ機能を強化するには、このオプションを有効にします。
maskAllInputs boolean true すべての <input> フィールドをマスクして、ユーザーが入力した機密データを保護します。
maskAllText boolean false ページ全体のテキストコンテンツをすべてマスクします。
sensitivityRules 配列(Array) []

要素レベルのプライバシーマスキングを微調整します。シンタックスに従って、sensityRules を追加します。

JSON
sensitvityRules:
[
    {rule: <Type>, selector: <Css Elements>}
]

記録で指定された CSS オブジェクトの情報に適用される ルールタイプ は 3 つあります。

  • exclude:情報をスキップします。
  • mask:情報をマスクします。
  • unmask:情報のマスクを解除します。

記録で指定された CSS オブジェクトの情報に適用される ルールタイプ は 3 つあります。

  • exclude:情報をスキップします。
  • mask:情報をマスクします。
  • unmask:情報のマスクを解除します。
例:
JSON
sensitivityRules: [
  { rule: "exclude", selector: "img" },
  { rule: "mask", selector: ".sensitive-field" },
  { rule: "unmask", selector: ".public-info" }
]
sessionReplayScriptUrl string (auto-derived)

デフォルトのリプレイ スクリプト ロケーションを上書きします。

一般:adrumExtUrlHttps + "adrum/session-replay/" + agentVersion

enableReplayFolderVersioning boolean true 互換性を保つため、エージェントのバージョンフォルダを使用します。フラットな構造からサービスを提供するには、false に設定します(例:https://your-cdn.com/replay)。

セッションリプレイの有効化

管理者はセッションリプレイのみを有効にできます。選択したブラウザアプリケーションのセッションリプレイを有効にするには、以下のオプションを実行します。
  1. コントローラ UI にログインします。
  2. 対象のブラウザアプリケーションを開きます。
  3. 左のナビゲーションメニューで、[Configuration] を選択します。
  4. **[インストルメンテーション(Instrumentation)]** をクリックします。
  5. [Session Replay] タブで、[Enable Session Replay] を選択します。
    BRUM のセッションリプレイの有効化。

セッションリプレイの表示

  1. [User Experience > Browser Apps] に移動します。
  2. セッションリプレイを有効にしたアプリケーションを選択します。
  3. [Sessions] を選択します。
  4. 記録が可能な場合、[Session Replay] に再生アイコンが表示されます。
  5. [Session Replay] タブを展開します。

[Session Replay] は、セッションのアクティブなセグメントを強調表示します。録画またはユーザー アクティビティがない場合は、空白の画面が表示されます。

ブラウザ RUM のセッションリプレイの表示

再生速度を調整できます。