更新履歴¶
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 リリースバージョンを使用することを推奨します。プラグインは Canvasautoモードでのみ動作し、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/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です。現在 6 種類のデータタイプをサポート:ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent。 -
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(ユーザー行動データ)収集を有効にするために使用します。デフォルトは無効です。