更新履歴¶
Browser SDK 3.3.25¶
2026-11-20
- Web RUM のフル版とスリム版に、初期化コールバック
onInitSuccessおよびonInitErrorを追加しました。remoteConfigurationを有効にすると、アプリケーションはリモート応答が処理済みであること、ローカル設定へのフォールバック、SDK 初期化の失敗を区別できます。二重起動と圧縮 Worker の状態分離に関する問題も修正しました。詳細は SDK の初期化結果を取得する を参照してください。 - Fetch のリソースイベントでは、利用できる場合はブラウザの Resource Timing を使います。SDK はアプリケーションのレスポンスボディを読み取ったり複製したりせずに、所要時間とバイト数を収集します。各計測記録は最大 1 件のリクエストに対応付けます。詳細は Fetch の所要時間を参照してください。
- フォームの変更後も古い初期値、選択項目、編集可能なテキストがセッションリプレイに残る場合がある問題を修正しました。リプレイとリソースイベントの URL に同じプライバシールールを適用し、分散トレーシングのリクエスト照合条件を厳密にしました。
- ページ離脱時、再接続時、アップロード滞留時のバッチ送信順を修正しました。独自の
toJSONを持つ拡張不可のオブジェクトを含むイベントも、元のプロパティ記述子を保持したまま送信できます。 - DOM のみを記録するリプレイ用バンドルを追加しました。イベントのエンコード、URL の解析、リプレイの圧縮を効率化し、Canvas のアイドル時の処理と Worker のメモリ使用量を削減しました。
- 別のウィンドウに属する要素のクリック収集を修正しました。Angular ルーターの再初期化、起動時のエラーのバッファリング、ルートのクエリパラメータのプライバシー処理を改善しました。
2026/09/16¶
Browser SDK 3.3.16 の新機能と改善:
- フル RUM パッケージおよびスリム RUM パッケージは、WebView 内で App の Visitor ID を再利用できます。
visitorId.enabledが有効で、現在のドメインがネイティブブリッジのホワイトリスト検証を通過し、App が同期FTWebViewJavascriptBridge.getVisitorid()インターフェースを提供して有効な識別子を返す場合、ルールに一致する XHR、Fetch のリクエストヘッダーおよび RUM のcontext.visitor_idでは、この識別子が優先的に使用されます。ブリッジが利用できない場合、戻り値が無効な場合、または読み取りに失敗した場合は、元の Web 識別子にフォールバックします。ネイティブ識別子の有効期間とローテーションは App が管理し、有効なネイティブ識別子を読み取った場合、Web 側のresetVisitorId()は単独では識別子を切り替えません。この機能を利用するには、このインターフェースをサポートするモバイル SDK が必要です。 - 最初の View の送信タイミングを改善しました。初期ページおよび各ルート切り替えで生成される View は、初めてサンプリングと送信の条件を満たした時点で直ちに送信をスケジュールし、バッチ送信間隔を待つ必要はありません。以降の更新は従来の間隔でまとめて送信されます。ページが非表示または離脱した際に各 View の最新状態を保持し、圧縮アップロードおよび圧縮失敗時のフォールバックに対応することで、短時間の訪問やページの高速切り替え時の View 欠落を減らします。
- 強制 Session とエラー補償サンプリングの連携を修正しました。
setForcedSession()またはstartSessionReplayRecording({ force: true })を呼び出すと、現在の Session の RUM データとすでに開始済みの Replay はエラーを待たずに送信でき、既存のエラーリプレイ用バッファを解放します。同時に、クロスタブの Session 切り替え、遅延失効時の再作成境界、および強制 Session 終了後の新しい Session に対するエラーマークと補償送信も修正しました。setForcedSession()自体は Replay 録画を開始しません。以降の Session は引き続き設定されたサンプリングルールに従います。 - 一部の JavaScript エラーでエラーメッセージのみとなり、位置情報が欠落する問題を修正しました。
Error.stackからスタックフレームを解析できない場合、ブラウザがwindow.onerror経由で提供するスクリプトアドレス、行番号、および利用可能な列番号を保持し、スクリプト構文エラーなどのケースをカバーします。既存のスタックは変更せず、ブラウザが提供しない位置情報を捏造することもありません。 - Session Replay で大規模なスタイルシートが失われる可能性がある問題を修正しました。DOM と CSS の合計が完全スナップショットの容量制限を超えていない場合、比較的大きな外部 CSS およびインライン CSS を保持し、スタイルシート単体のルール数、文字数、処理時間の制限、または通常の文字列長制限によってリプレイのスタイルが欠落することを減らします。プライバシー処理と全体の容量保護は引き続き維持し、スタイルシートを読み取れない場合や容量を超えた場合は従来のフォールバックロジックを使用します。
- Core、フル RUM、スリム RUM、Logs の公開 TypeScript 宣言を実行時 API と一致するよう修正しました。フルおよびスリム RUM パッケージは
TraceTypeを直接インポートでき、traceTypeはサポートされる文字列値を受け入れます。旧設定のエイリアス、公開型のエクスポート、Logs の'all'転送設定、ログレベルメソッドの宣言を補完し、既存の正当な使用方法における型エラーを減らします。 - JSON 送信リクエストの
Content-Typeをapplication/json;charset=UTF-8に修正し、圧縮アップロードのケースもカバーしました。 - SDK リポジトリにパフォーマンス評価レポートと、CDN 接入および npm 接入それぞれに向けたパフォーマンスセルフチェックガイドを追加し、
performance/ディレクトリにまとめて収録しました。SDK がページパフォーマンスに与える影響を評価しやすくなります。
2026/09/07¶
RUM SDK 3.3.15 の新機能と改善:
visitorId設定を追加し、ルールに一致する XHR および Fetch に安定した匿名 Visitor ID を注入し、RUM のcontext.visitor_idに関連付けます。同一 Origin の文字列プレフィックス、正規表現、関数によるマッチング、TTL、ストレージのフォールバック、resetVisitorId()によるローテーションをサポートします。Session や分散型トレーシングのサンプリングには依存しません。訪問者識別子(Visitor ID)- Visitor ID は Fetch パラメータおよび XHR 同期コールバック内のリクエストセマンティクスを保持し、一致しないリクエストでは既存のカスタムヘッダーを保持します。同一タイムスタンプでのローテーションでは古いフォールバック ID を復元せず、リソース関連ヘッダーの占有を禁止し、View/イベントコンテキストが SDK の識別子を上書きすることを防ぎます。
- クロス iframe の
Requestにおける業務リクエストヘッダーの保持、XHR 同期失敗後の再試行時の識別子重複、ネイティブWeakSetがない場合の Visitor ID 初期化の互換性問題を修正しました。初期化前にバッファされたイベントの識別子を補完し、RUM の共通コンテキストを読み取るたびにグローバルフィールドを繰り返しディープコピーすることを避けます。
2026/08/31¶
RUM SDK 3.3.14 の新機能と改善:
enablePrivacyForActionName設定を追加しました(デフォルトは無効)。有効にすると、自動 Action 名は DOM のプライバシーレベルに従います。マスクされたコンテンツには固定のプレースホルダー名を使用し、プライベートなフォームフィールドではテキストや標準命名属性が漏洩せず、非表示のサブツリー内のクリックでは自動 Action を生成しません。明示的に指定された業務名は非表示でないノードでは引き続き使用できます。ユーザー操作 Action
2026/08/28¶
RUM SDK の後続バージョンにおける新機能と改善:
- ブラウザが User-Agent Client Hints を提供している場合に、
platformVersionを通じて Windows 10 と Windows 11 を区別できるようにし、最初の RUM データが同一のシステムバージョン情報を使用することを保証します。この機能がサポートされない場合、高エントロピー値の返却が拒否された場合、またはクエリがタイムアウトした場合は、従来の User-Agent を引き続き使用します。RUM データ構造
2026/08/26¶
RUM SDK 3.3.11 の新機能と改善:
- Wujie(無界)などのマイクロフロントエンドにおける、Session Replay のクロス iframe JavaScript レルム要素の認識を修正しました。iframe レルムで作成されて現在のページのオープン ShadowRoot にマウントされたネイティブフォーム入力、DOM 変更、および有効化済みの Canvas 録画が、正常にリプレイに含まれるようになりました。フォーム要素の
value、checked、selectedIndex属性への代入も記録できます。Canvas コマンド収集モードでは、クロスレルム Canvas は自動的にビットマップスナップショットをフォールバックとして使用します。この機能には iframe 内部のドキュメントやクローズド Shadow DOM は含まれません。Session Replay 導入ガイド
RUM SDK 3.3.10 の新機能と改善:
- 自動 Action はオープン Shadow DOM 内のクリック要素をサポートし、iframe の JavaScript レルムで作成された後に ShadowRoot にマウントされた要素(Wujie マイクロフロントエンドなど)を含みます。SDK は実際のクリック対象に基づいて名前と Shadow 境界付きの位置情報を生成し、テーブル行やカードなどのコンテナの集約テキストを誤って Action 名として扱わないようにします。クローズド Shadow DOM は引き続きブラウザのカプセル化境界の制限を受けます。ユーザー操作 Action
2026/08/25¶
RUM SDK 3.3.9 の新機能と改善:
- SPA の
route_changeView は Chrome Soft Navigation API をサポートします。ブラウザがネイティブサポートしている場合、ルート切り替え時に FCP、LCP、LCP 要素セレクター、およびview_navigation_typeを追加できます。ネイティブ API をサポートしていない場合は、引き続き Navigation API、History API、または Hash ルーティング互換ロジックを通じて Route View を作成し、push、replace、traverseのナビゲーション種別を保持しますが、そのルート切り替えの FCP/LCP は補完しません。RUM データ構造 - ページが継続的に更新されている間に View データの送信が遅れる可能性がある問題を修正しました。送信待ちの View が更新された場合でも元のバッチの送信期限を引き続き使用し、既存の送信間隔で最新データを送信することを保証します。
2026/08/20¶
RUM SDK 3.3.8 の新機能と改善:
- WebSocket Resource にセグメント終了時のページパスフィールド
resource_websocket_end_view_pathを追加しました。セグメント開始時のパスは標準フィールドview_pathを再利用し、Resource エクスプローラーで接続開始または終了ページに基づいてフィルタリングできます。WebSocket 長接続収集
2026/08/11¶
RUM SDK 3.3.7 の新機能と改善:
- オプションの WebGL/WebGL2 Session Replay プラグインを追加し、NPM と CDN による導入をサポートしました。描画駆動型で、予算制約のあるピクセルスナップショットにより、ゲームや可視化画面を記録します。WebGL 実装は RUM メインパッケージから分離されており、WebGL を使用しないアプリケーションはプラグインを導入する必要はありません。Canvas 録画ガイド
allowTraceHeaderWithoutSession設定を追加しました。有効にすると、現在の RUM Session がサンプリング対象でなくても、allowedTracingUrlsに一致する XHR および Fetch リクエストに Trace Header を注入できます。これによって Session が作成されたり強制的に有効化されたりすることはなく、その未サンプリング Session の RUM データが送信されることもありません。Web アプリケーションの導入- Canvas 2D の自動録画と command capture を改善し、より多くの描画 API と状態を補完しました。部分的な変更や透明度の変化の取りこぼし、非同期フレームの順序乱れ、ズームスナップショットのカバレッジ不足、reset と bitmap の分割送信によるちらつきを修正しました。複数 Canvas では公平なスケジューリング、変更検出、有界並列処理を使用し、動的画面の連続性とページパフォーマンスを両立します。Canvas 録画ガイド
- 大規模 DOM、動的 Shadow DOM、スタイルシートのリプレイを改善しました。大きなスナップショットや突発的な DOM 変更には分割、アトミックコミット、ベースライン復元を採用し、ノード移動が「削除後に追加」に分割されることで発生するページのちらつきや、大きな要素または CSS スタイルの欠落を減らします。Session Replay 導入ガイド
- 圧縮アップロードと Session Replay の転送信頼性を強化しました。圧縮 Worker で異常が発生した場合は自動的に非圧縮アップロードへフォールバックし、View、Action、Error、Resource などの RUM データの欠落を防ぎます。また、エンコードのバックプレッシャー、ネットワーク再試行、ページ離脱時にも Replay のベースラインと後続セグメントの順序を維持し、不完全または欠落したリプレイを減らします。
- Hash Router View URL のクエリパラメータ解析を修正し、
#/path?key=value内のパラメータが View URL Query に正しく書き込まれるようになりました。RUM データ構造
アップグレードの注意:WebGL Replay は SDK
3.3.7から提供され、RUM メインパッケージのバージョン>= 3.3.7が必要です。また、プラグインとメインパッケージを同じ SDK リリースバージョンで使用することを推奨します。プラグインは Canvas のautoモードでのみ動作し、init()時に WebGL エンジンの初期化より前に登録する必要があります。GL コマンドの再生、フレーム単位の動画、OffscreenCanvas録画は提供しません。Canvas 2D で名前付き品質プリセットを使用していない場合、自動収集の interval/cooldown のデフォルト値が
1000/1000 msから250/250 msに変更されました。low、medium、highプリセットでもより高速な Canvas 2D スケジューリングを採用します。動的画面はより連続的になりますが、CPU、エンコード、アップロードのオーバーヘッドが増加する可能性があります。WebGL で interval/cooldown を明示的に設定していない場合は、より保守的な GPU 読み戻し間隔を引き続き維持します。
replayCanvasSamplingの正数は snapshot パスを選択するために使用され、収集頻度を表すものではありません。頻度は interval、cooldown、backoff によって制御されます。replayCanvasQualityの文字列プリセットは品質、sampling、スケジューリング予算を同時に調整しますが、数値の場合はエンコード品質のみを調整します。
2026/07/29¶
RUM SDK 3.3.6 の新機能:
- React、Vue、Angular、Next.js、Nuxt のフレームワークプラグインを追加し、ルートテンプレートに基づく View の収集をサポートするとともに、対応するフレームワークエラーのエントリポイントを提供します。導入ガイド
- Next.js App Router、Pages Router、Nuxt 3/4 のクライアント統合。SSR 導入ガイド
- 実験的なネイティブ WebSocket 長接続収集を追加し、接続統計を RUM Resource として集約します。WebSocket 長接続収集
startView()はurlで View URL を指定でき、手動 View やフレームワーク Router との統合に使用できます。カスタム ViewstartSession()を追加し、現在の Session を即座に終了してセッションサンプリングを再実行できるほか、実行時にsessionSampleRateを上書きできます。サンプリングと実行時 Session 制御
2026/06/30¶
RUM SDK 3.3.3 の新機能:
- スリム版 RUM SDK を追加しました。NPM と CDN による導入をサポートし、View、Resource、Long Task、Error、Action、Context、カスタムイベント、分散型トレーシングなどの一般的な RUM 機能を保持しますが、Session Replay、Canvas 録画、
compressIntakeRequestsによる送信圧縮は含みません。スリム版 RUM SDK 導入ガイド
2026/04/17¶
Canvas SessionReplay 録画を追加しました。参考情報 Resource Hook 機能を追加しました。参考情報
2025/04/23¶
remoteConfiguration を追加し、データ収集設定をリモートで動的に変更できるようにしました。
2025/04/13¶
shouldMaskNode設定を追加し、Session Replay ノードのマスク効果をカスタマイズできるようにしましたsessionOnErrorSampleRate設定を追加し、エラーセッションのイベントのみを収集できるようにしました。参考情報sessionReplayOnErrorSampleRate設定を追加しました。エラーに関連する Session Replay データのみを収集できるようにします。参考情報
2022/9/29¶
初期化パラメータに isIntakeUrl 設定を追加しました。リクエストリソースの URL に基づいて対応するリソースデータを収集する必要があるかどうかを判断するために使用し、デフォルトではすべて収集します。
2022/3/10¶
-
分散型トレーシングツールの種類を設定する
traceTypeを追加しました。設定しない場合はデフォルトでddtraceになります。現在、ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparentの 6 種類のデータタイプをサポートしています。 -
allowedTracingOriginsを追加し、Trace コレクターに必要なヘッダーを注入できるすべてのリクエストのリストを指定できるようにしました。リクエストの origin または正規表現を指定できます。 -
既存の設定項目
allowedDDTracingOriginsと新規設定項目allowedTracingOriginsは同じ機能の設定です。どちらか一方を設定でき、両方を設定した場合はallowedTracingOriginsがallowedDDTracingOriginsより優先されます。
2021/5/20¶
-
V2 バージョンのメトリクスデータ変更に伴い、DataKit 1.1.7-rc0 以降のバージョンにアップグレードする必要があります。詳細は DataKit 設定 を参照してください。
-
SDK を V2 バージョンにアップグレードし、CDN アドレスを
https://static.guance.com/browser-sdk/v2/dataflux-rum.jsに変更しました。 -
rum_web_page_performance、rum_web_resource_performance、js_error、pageのメトリクスデータ収集を削除し、view、action、long_task、errorのメトリクスデータ収集を追加しました。 -
初期化設定に
trackInteractionsを追加しました。Action(ユーザー行動データ)の収集を有効化するために使用し、デフォルトは無効です。