セッションリプレイ

CloudWatch RUM セッションリプレイを使用すると、ウェブアプリケーションのエンドユーザーセッションを記録できます。これらのセッションを再生することで、ユーザーが経験したことを視覚的に確認し、問題の特定、ユーザーの行動の理解、問題のトラブルシューティングに役立てることができます。

ユーザーのプライバシーを保護するため、ページ上のすべてのテキスト入力および表示テキストはデフォルトでマスクされます。これは、名前、住所、その他の個人データなどの機密情報が記録されないことを意味します。

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

セッションリプレイを使用するには、aws-rum-web パッケージから RRWebPlugin をインポートし、ウェブクライアント設定の eventPluginsToLoad 配列に追加します。ウェブクライアントを JavaScript モジュールとしてインストールする方法に関する詳細については、CloudWatch RUM ウェブクライアントの設定 を参照してください。

次の例は、リプレイセッションを有効化する方法を示しています。

import { AwsRum, AwsRumConfig } from 'aws-rum-web';
import { RRWebPlugin } from 'aws-rum-web/plugins/rrweb';

const config: AwsRumConfig = {
    identityPoolId: 'us-west-2:00000000-0000-0000-0000-000000000000',
    sessionSampleRate: 1,
    telemetries: ['errors', 'performance', 'http'],
    eventPluginsToLoad: [new RRWebPlugin()]
};

const awsRum: AwsRum = new AwsRum(
    'APPLICATION_ID',
    '1.0.0',
    'us-west-2',
    config
);

RRWebPlugin は、サンプリングレートや記録動作などのオプションの設定オプションを受け入れます。使用可能な設定オプションの完全なリストについては、GitHub の「CloudWatch RUM ウェブクライアントの設定」を参照してください。

プライバシーとデータマスキング

セッションリプレイは、デフォルトでページのすべてのテキスト入力とテキストコンテンツをマスクします。これには、フォームフィールド、ラベル、段落、および DOM にレンダリングされるその他のテキストが含まれます。マスクされたコンテンツは、再生中にプレースホルダー文字として表示され、個人を特定できる情報 (PII) が取得または保存されないようにします。

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

セッションリプレイを有効にすると、CloudWatch RUM コンソールで記録されたセッションを表示できます。アプリモニターに移動し、[セッションリプレイ] タブを選択します。このタブには、セッション ID、期間、開始時間、ブラウザタイプ、デバイスタイプなどの詳細を含む、記録されたセッションのリストが表示されます。セッションをフィルタリングして、すべてのセッション、エラーのあるセッション、またはエラーのないセッションを表示できます。

セッションリプレイがあるセッションは、[セッション] タブでも見つけることができます。リプレイが利用可能なセッションには、その横に再生ボタンが表示されます。再生プレイヤーを開くには、再生ボタンを選択します。

再生プレイヤーを開くセッションを選択します。プレイヤーは、ユーザーのセッションを視覚的に再生し、右側には操作のタイムラインが含まれています。タイムラインには、ページナビゲーション、スクロール、クリック、テキスト入力などの各ユーザー操作と、各操作が発生したときのタイムスタンプが表示されます。再生コントロールを使用して再生速度 (1 倍、2 倍、4 倍、または 8 倍) を調整したり、非アクティブ期間をスキップしたりできます。