Session Replay for Mobile RUM (Beta)

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:

Optimize the user experience.
Debug the errors for application crashes.
Diagnose the reasons for application slowness.

Note: Disclaimer:

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.

考慮すべき点：

ベータ段階では、各アカウントは 1 ヵ月あたり最大 20,000 件のセッションリプレイを記録できます。ベータ版が終了したら、アカウントマネージャに問い合わせて、完全な機能をご購入ください。

ストレージはデフォルトで 8 日間に設定されており、ベータ版では延長することはできません。ベータ版が終了したら、拡張ストレージ SKU を購入してストレージを追加できます。

前提条件

セッションリプレイを使用するには、次の条件が満たされていることを確認してください。

コントローラ 25.1 以降
iOS エージェント 25.2 以降
Android エージェント 25.2 以降

セッションリプレイをレポートするための iOS エージェントの設定

モバイルアプリケーションのセッションリプレイをレポートするには、次のように iOS エージェントを設定する必要があります。

Objective-C

#import <ADEumInstrumentation/ADEumInstrumentation.h>
#import "AppDelegate.h"
  
    // ...
    -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    {
        ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>];
        //The default SaaS EUM Server and Screenshot Service are in the Americas,
        // so you can omit the following settings if you are in the Americas.
        config.collectorURL = @"https://<your_region>-col.eum-appdynamics.com";
        config.screenshotURL = @"https://<your_region>-image.eum-appdynamics.com";
        config.sessionReplayURL = @"https://<your_region>-blob-service.eum-appdynamics.com";
        [ADEumInstrumentation initWithConfiguration: config];
        // other tasks
        return YES;
     }

Swift

#import <ADEumInstrumentation/ADEumInstrumentation.h>
#import "AppDelegate.h"
  
    // ...
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>)
        config.collectorURL = "https://<your_region>.eum-appdynamics.com"
        config.screenshotURL = "https://<your_region>-image.eum-appdynamics.com"
        config.sessionReplayURL = "https://<your_region>-blob-service.eum-appdynamics.com"
        ADEumInstrumentation.initWith(config)
        // other tasks
        return true
    }
// ...

注: オレゴン（PDX）リージョンにリージョンを追加しないでください。

セッションリプレイをレポートするための Android エージェントの設定

モバイルアプリケーションのセッションリプレイをレポートするには、次のように Android エージェントを設定する必要があります。

以下の方法でエージェントを初期化します。

.withSessionReplayEnabled(true)
.withBlobServiceURL(configHelper.getSessionReplayUrl())

import com.appdynamics.eumagent.runtime.Instrumentation;
...
@Override public void onCreate(Bundle savedInstanceState) {
  Instrumentation.start(AgentConfiguration.builder()
    .withAppKey("<EUM_APP_KEY>")
    .withContext(getApplicationContext())
    // The default SaaS EUM Server and Screenshot Service are in the Americas,
    // so you can omit the following settings if you are in the Americas.
    .withSessionReplayEnabled(true)
    .withBlobServiceURL(configHelper.getSessionReplayUrl()) 
    .build());
  ...
}

アプリケーションモジュールレベルの build.gradle ファイルで、セッションリプレイ SDK を追加します。


...
...
repositories {
        maven {
            url = "https://sdk.smartlook.com/android/release"
        }
    }
...
...
dependencies {
        implementation 'com.cisco.android:sr-instrumentation-session-recording-core:1.0.12' 
}

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

管理者はセッションリプレイのみを有効にできます。選択したモバイルアプリケーションのセッションリプレイを有効にするには、以下のオプションを実行します。

コントローラ UI にログインします。
対象のモバイルアプリケーションを開きます。
左のナビゲーションメニューで、[Configuration] を選択します。
モバイルアプリケーショングループの設定
[Session Replay] タブで、[Enable Session Replay] を選択します。
注: Xcode のメインスレッドチェッカー
デバッグモードで iOS アプリを起動すると、数秒間停止することがあります。セッションリプレイを有効にすると、セッションリプレイが開始し警告が表示されます。この問題は、Xcode のメインスレッドチェッカーの診断によって引き起こされます。
```
Main Thread Checker: UI API called on a background thread: -[UIView drawViewHierarchyInRect:afterScreenUpdates:]
```
この警告は無害であり、iOS エージェントがバックグラウンドで画面をキャプチャしていることが原因で発生します。別の方法（メインスレッドでスクリーンショットをキャプチャする）は、アプリケーション UI の不具合を引き起こす可能性があります。そのため、この方法で実装し、この警告を表示することは、シームレスな記録機能を有効にするために必要なトレードオフです。
この警告は、デバッグ中にアプリケーションが短時間フリーズする場合にも表示されます。このフリーズは実稼働環境ビルドでは発生せず、メインスレッドチェッカーの Xcode 診断オプションが原因で発生します。
このオプションは、それぞれの実行スキームの診断オプションでオフにすることができます。詳細については、「メモリ、スレッド、クラッシュの問題の早期診断」の「バックグラウンドセクションの不適切な UI 更新の検出」セクションを参照してください。

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

セッションリプレイでは、複数の録音とユーザーインタラクションが組み合わされています。セッションリプレイを表示するには、以下の手順を実行します。

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

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

セッションリプレイの表示中に、以下のアクションを実行できます。

再生速度を調整する。
[Video] モードと [Wireframe] モードを切り替えます。[Wireframe] モードでは、セッションリプレイは UI レイアウトだけを表示し、テキストはマスクされます。