コンテンツにスキップ

更新履歴

2026/09/16

Browser SDK 3.3.16 の追加および改善：

  1. フル RUM パッケージとスリム RUM パッケージは、WebView でアプリの Visitor ID を再利用できます。 visitorId.enabled を有効にし、現在のドメインがネイティブブリッジのホワイトリスト検証を通過し、かつアプリが同期 FTWebViewJavascriptBridge.getVisitorid() インターフェースを提供して有効な識別子を返す場合、ルールに一致する XHR、Fetch リクエストヘッダーおよび RUM context.visitor_id は優先的にその識別子を使用します。ブリッジが利用できない、 戻り値が無効、または読み取りに失敗した場合は、従来の Web 識別子にフォールバックします。ネイティブ識別子の有効期間とローテーションはアプリが 管理します。有効なネイティブ識別子を読み取った場合、Web の resetVisitorId() は単独で識別子を変更しません。 この機能を使用するには、このインターフェースに対応するモバイル SDK が必要です。
  2. 最初の View の送信タイミングを最適化：初期ページおよびルート切り替えのたびに生成される View は、初めて サンプリングと送信条件を満たしたときに直ちに送信をスケジュールし、バッチ送信間隔を待つ必要はありません。その後の更新は従来のリズムで 結合して送信されます。ページが非表示または終了した場合は各 View の最新状態を保持し、圧縮アップロードおよび圧縮 失敗時のダウングレードにも対応し、短時間のアクセスやページ切り替えが速い場合の View の欠落を減らします。
  3. 強制 Session とエラー補償サンプリングの相互作用を修正。setForcedSession() または startSessionReplayRecording({ force: true }) を呼び出した後、現在の Session の RUM データ および起動済みの Replay はエラーを待たずに送信され、既存のエラーリプレイバッファを解放します。 また、タブ間の Session 切り替え、遅延期限切れ時の継続境界、および強制 Session 終了後の新しい Session のエラーマークと補償送信も修正しました。setForcedSession() 自体は Replay 録画を開始しません。その後の Session は設定済みのサンプリングルールに従います。
  4. 一部の JavaScript エラーにエラーメッセージしかなく、位置情報が欠落している問題を修正。Error.stack からスタックフレームを解析できない場合、ブラウザが window.onerror を介して提供するスクリプトアドレス、行番号、 および利用可能な列番号を保持し、スクリプト構文エラーなどのシナリオをカバーします。既存のスタックは変更されず、ブラウザが 提供しない位置情報が補完されることはありません。
  5. Session Replay で大きなスタイルシートが失われる可能性がある問題を修正。DOM と CSS の合計が フルスナップショット容量制限を超えない場合、大きな外部リンクおよびインライン CSS を保持し、個々のスタイルシートのルール数、 文字数、処理時間制限、または通常の文字列長制限によるリプレイのスタイル欠落を減らします。プライバシー 処理と全体の容量保護は引き続き保持されます。スタイルシートを読み取れない、または容量を超える場合は従来のダウングレードロジックを使用します。
  6. Core、フル RUM、スリム RUM、Logs の公開 TypeScript 宣言を修正し、ランタイム API と一致するようにしました。フルおよびスリム RUM パッケージは TraceType を直接インポートでき、 traceType はサポートされている文字列値を受け入れます。旧設定のエイリアス、公開型のエクスポート、Logs の 'all' 転送設定、およびログ レベルメソッドの宣言を補完し、既存の有効な使用法での型エラーを減らします。
  7. JSON 送信リクエストの Content-Type を application/json;charset=UTF-8 に修正し、 圧縮アップロードのシナリオもカバーします。
  8. SDK リポジトリにパフォーマンス評価レポート、および CDN と npm それぞれの導入向けパフォーマンス自己チェックガイドを追加し、 performance/ ディレクトリにまとめました。SDK がページパフォーマンスに与える影響を評価しやすくなります。

2026/09/07

RUM SDK 3.3.15 の追加および改善：

  1. visitorId 設定を追加し、ルールに一致する XHR と Fetch に安定した匿名訪問者識別子を注入し、 RUM context.visitor_id にその値を関連付けます。同一オリジンの文字列プレフィックス、正規表現、 関数マッチング、および TTL、ストレージダウングレード、resetVisitorId() ローテーションをサポートします。Session または分散型トレーシングのサンプリングには依存しません。 訪客标识 Visitor ID
  2. Visitor ID は Fetch パラメータと XHR 同期コールバック内のリクエストセマンティクスを保持し、未マッチのリクエストは既存のカスタムヘッダーを保持します。 同じタイムスタンプでのローテーションでは古いダウングレード ID は復元されず、リソース関連ヘッダーの占有を禁止し、View/イベントコンテキストが SDK 識別子を上書きしないようにします。
  3. クロス iframe Request のビジネスリクエストヘッダー保持、XHR 同期失敗後の再試行時の識別子重複、 ネイティブ WeakSet がない場合の Visitor ID 初期化の互換性問題を修正。初期化前にバッファリングされたイベントの識別子を補完し、 RUM パブリックコンテキストを読み取るたびにグローバルフィールドを繰り返しディープコピーしないようにします。

2026/08/31

RUM SDK 3.3.14 の追加および改善：

  1. enablePrivacyForActionName 設定を追加（デフォルトはオフ）。有効にすると、自動 Action 名は DOM プライバシーレベルに従います：マスクコンテンツは固定のプレースホルダー名を使用し、プライベートフォームフィールドはテキストや標準の命名属性を漏らさず、非表示サブツリー内のクリックでは自動 Action を生成しません。明示的に指定されたビジネス名は、非表示ノード以外では引き続き使用できます。用户操作 Action

2026/08/28

RUM SDK 以降のバージョンの追加および改善：

  1. ブラウザが User-Agent Client Hints を提供する場合、platformVersion で Windows 10 と Windows 11 を 区別し、最初の RUM データが同じシステムバージョン情報を使用することを保証します。 この機能に対応していない、高エントロピー値の返却を拒否する、またはクエリがタイムアウトする場合は、従来の User-Agent を使用し続けます。 RUM 数据结构

2026/08/26

RUM SDK 3.3.11 の追加および改善：

  1. 無界（Wujie）などのマイクロフロントエンドで Session Replay がクロス iframe JavaScript realm の要素を認識できない問題を修正：iframe realm で作成され、現在のページのオープン ShadowRoot にマウントされたネイティブフォーム入力、 DOM 変更、および開始済みの Canvas 録画が正常にリプレイに含まれるようになりました。フォーム要素の value、checked、selectedIndex プロパティの代入も記録できます。Canvas コマンドキャプチャモードでは、 クロス realm Canvas は自動的にビットマップスナップショットにフォールバックします。この機能には iframe 内部ドキュメントや closed Shadow DOM は含まれません。 Session Replay 接入说明

RUM SDK 3.3.10 の追加および改善：

  1. 自動 Action はオープン Shadow DOM 内のクリック要素をサポートします。iframe の JavaScript realm で作成され、ShadowRoot にマウントされた要素 （例：無界マイクロフロントエンド）も含みます。SDK は実際のクリックターゲットに基づいて名前と Shadow 境界付きの位置情報を生成し、テーブル行や カードなどのコンテナの集約テキストを Action 名として誤用しないようにします。Closed Shadow DOM はブラウザのカプセル化境界の制限を受けます。 用户操作 Action

2026/08/25

RUM SDK 3.3.9 の追加および改善：

  1. SPA route_change View は Chrome Soft Navigation API をサポートします。ブラウザがネイティブにサポートしている場合、 ルート切り替えで FCP、LCP、LCP 要素セレクター、および view_navigation_type を追加できます。ネイティブ API をサポートしない場合は、Navigation API、History API、または Hash ルートの互換ロジックを介して Route View を引き続き作成し、 push、replace、traverse のナビゲーションタイプを保持しますが、そのルートの FCP/LCP は追加されません。RUM 数据结构
  2. ページが継続的に更新されている間、View データの送信が遅れる問題を修正し、送信待ちの View が更新されても 元のバッチの送信期限が引き続き使用され、既存の送信間隔で最新データが送信されることを保証します。

2026/08/20

RUM SDK 3.3.8 の追加および改善：

  1. WebSocket Resource にセグメント終了ページパスフィールド resource_websocket_end_view_path を追加。セグメント開始パスは標準フィールド view_path を再利用し、 Resource エクスプローラーで接続開始ページまたは終了ページでフィルタリングできます。 WebSocket 长连接采集

2026/08/11

RUM SDK 3.3.7 の追加および改善：

  1. オプションの WebGL/WebGL2 Session Replay プラグインを追加し、NPM と CDN での導入をサポートします。 描画ドライバーと予算制約付きピクセルスナップショットにより、ゲームやビジュアライゼーション画面を記録します。WebGL 実装は RUM メインパッケージから分離されており、WebGL を使用しないアプリケーションはプラグインを導入する必要はありません。 Canvas 录制使用手册
  2. allowTraceHeaderWithoutSession 設定を追加。有効にすると、現在の RUM Session が サンプリングに該当しなくても、allowedTracingUrls に一致する XHR と Fetch リクエストに Trace Header を注入できます。 Session が作成されたり強制有効化されたりすることはなく、その未サンプリング Session の RUM データも送信されません。Web 应用接入
  3. Canvas 2D の自動録画とコマンドキャプチャを最適化し、より多くの描画 API と状態を追加。 部分的な変更や透明度変更の取りこぼし、非同期フレームの順序乱れ、ズームスナップショットの不完全な上書き、reset と bitmap が別々に送信されることによるちらつきを修正。複数 Canvas では公平なスケジューリング、変更検出、および境界付き並行処理を使用し、 動的画面の連続性とページパフォーマンスを両立します。 Canvas 录制使用手册
  4. 大きな DOM、動的な Shadow DOM、スタイルシートのリプレイを最適化し、大きなスナップショットと突発的な DOM 変更は 断片化、アトミックコミット、ベースライン復元を使用して、ノード移動が「削除してから追加」に分割されることによるページの ちらつきや、大きな要素や CSS スタイルの欠落を軽減します。 Session Replay 接入说明
  5. 圧縮アップロードと Session Replay 転送の信頼性を強化：圧縮 Worker が異常な場合は自動的に 非圧縮アップロードにフォールバックし、View、Action、Error、Resource などの RUM データの損失を防ぎます。また、 エンコード背圧、ネットワーク再試行、ページ終了時にも Replay のベースラインとその後のセグメント順序を維持し、不完全 または欠落したリプレイを減らします。
  6. 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 の追加：

  1. React、Vue、Angular、Next.js、Nuxt フレームワークプラグイン。ルートテンプレートに基づく View 収集をサポートし、 対応するフレームワークエラーエントリを提供します。接入说明
  2. Next.js App Router、Pages Router、Nuxt 3/4 のクライアント統合。 SSR 接入说明
  3. 実験的なネイティブ WebSocket 長接続収集。接続統計を RUM Resource として集計します。 WebSocket 长连接采集
  4. startView() は url による View URL の指定をサポートします。手動 View とフレームワーク Router 統合で使用できます。自定义 View
  5. startSession() を追加。現在の Session を即座に終了し、セッションサンプリングを再実行でき、実行時に sessionSampleRate を上書きできます。采样与运行时 Session 控制

2026/06/30

RUM SDK 3.3.3 の追加：

  1. スリム版 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

  1. shouldMaskNode 設定を追加し、session replay ノードのマスク効果をカスタマイズします
  2. sessionOnErrorSampleRate 設定を追加し、エラーセッションイベントのみを収集します。参考
  3. sessionReplayOnErrorSampleRate 設定を追加し、エラーに関連する Session Replay データのみを収集します 参考

2022/9/29

初期化パラメータに isIntakeUrl 設定を追加。リクエストリソース URL に基づいて対応するリソースデータを収集するかどうかを判断するために使用します。デフォルトではすべて収集します。

2022/3/10

  1. traceType 設定を追加し、分散型トレーシングツールのタイプを指定します。設定しない場合、デフォルトはddtraceです。現在 6 種類のデータタイプをサポートしています：ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent。

  2. allowedTracingOrigins を追加し、Trace 収集器に必要なヘッダーを注入できるすべてのリクエストリストを指定します。リクエストの origin でも正規表現でも指定できます。

  3. 元の設定項目 allowedDDTracingOrigins と新しい設定項目 allowedTracingOrigins は同じ機能設定です。どちらか一方を設定できます。両方設定した場合、allowedTracingOrigins の重みが allowedDDTracingOrigins より高くなります。

2021/5/20

  1. V2 バージョンのメトリクスデータ変更に合わせて、DataKit 1.1.7-rc0 以降のバージョンへのアップグレードが必要です。詳細は、DataKit 配置 を参照してください。

  2. SDK は V2 バージョンにアップグレードされ、CDN アドレスは https://static.guance.com/browser-sdk/v2/dataflux-rum.js に変更されました。

  3. rum_web_page_performance、rum_web_resource_performance、js_error、page メトリクスデータの収集を削除し、view, action, long_task, error メトリクスデータの収集を追加しました。

  4. 初期化に trackInteractions 設定を追加し、Action（ユーザー行動データ）収集を有効にします。デフォルトではオフです。

フィードバック

このページは役に立ちましたか？