ホーム
RUM
HarmonyOS
変更履歴
ft_sdk
0.1.18 (2026/10/30)
独立した ft_session_replay モジュール(実験的)のサポートを追加し、録画中の Session、View、Error および ArkWeb データを関連付けます。詳細はセッションリプレイの更新説明 を参照してください。
パーセントサンプリング API を追加:setSessionSamplingRate(...)、setSessionOnErrorSamplingRate(...)、setLogSamplingRate(...)、setTraceSamplingRate(...)。値の範囲は [0,100] で、リモート設定のキャッシュと動的更新をサポートします。旧 API は [0,1] の単位を維持し引き続き使用できます。新 API に切り替える際は値を 100 倍してください。
Resource の転送情報とリクエスト開始時のネットワークスナップショットを追加:転送フィールドには resource_request_size、resource_http_protocol、resource_connection_reuse が含まれ、ネットワークフィールドには network_available、network_validated、network_downlink_kbps、network_uplink_kbps、network_signal_strength が含まれます。システムのサポート状況に応じて収集されます。
FTRUMConfig.setNetworkErrorHandler(...) を追加し、onExceptionWithFilter(...) コールバックを通じて HTTP レスポンスのないローカルネットワークエラーを処理します。true を返すと Network Error のみをフィルタし、Resource は保持し、カスタムフィールドを追加できます。Network Error の error_type の不整合を修正し、network_error に統一しました。
アプリケーション安定性指標を追加:foreground_crash_free_duration、background_crash_free_duration はそれぞれフォアグラウンド/バックグラウンドのクラッシュなし時間を記録し、view_long_task_rate はページのロングタスク所要時間の割合を記録します。
FTSDKConfig.setAllowWebViewHost(...) を追加し、WebView RUM と Replay の Host 範囲を統一的に制御します。あわせて FTRUMConfig.setAllowWebViewHost(...) を非推奨にしました。
FTSDK.getLogConfig() を追加し、現在のログ設定を取得できるようにして、既存の設定を保持したまま更新しやすくしました。
HTTPS Resource の接続所要時間の統計を変更し、resource_tcp、resource_connect_time に TLS ハンドシェイクの所要時間を含めました。Resource の時間記録のずれと、ゼロ所要時間データが欠落する問題を修正しました。
大容量データのアップロード戦略を変更し、大容量レコードはレコード全体を個別にアップロードするようにして、Error などのデータがローカルのサイズ制限により破棄されたりアップロードできなくなったりするのを防ぎます。既存の連携に変更は不要です。
ページ切り替え、フォアグラウンド/バックグラウンド切り替え、セッション更新および SDK 再初期化時の View 収集、所要時間、データ関連付けの異常を修正し、進行中の Resource は元の関連付けを保持します。startView(...) は呼び出しごとに新しい View を作成し、stopView(...) は既存の属性をマージし、同名フィールドは終了時の値が優先されます。
自動クリックおよび起動イベントの setActionTrackingHandler(...) コールバックを修正:HandlerAction は名前と属性を変更でき、null は収集をスキップし、undefined はデフォルトの収集を維持します。
エラーサンプリングセッションの Action、View が誤って通常サンプリングとして報告される問題、および長時間滞在するページの View キャッシュが早すぎるタイミングでクリアされる問題を修正しました。
初期化またはアカウント切り替え後の View ユーザー情報の誤り、およびアプリ再起動後にプライバシーデバイス UUID と匿名ユーザー ID が変化する問題を修正しました。
setOnlySupportMainProcess(true) が有効にならない問題を修正しました。サブプロセスを監視する必要がある場合は、インストール前に setOnlySupportMainProcess(false) を設定してください。
SDK のバックグラウンドセッションとメモリ管理を最適化し、バックグラウンドの定期チェックとメモリ使用量を削減しました。applyFTAxiosTrack(...) で同一クライアントが重複登録される問題を修正し、戻り値に dispose() を追加して Axios 収集インターセプターを削除できるようにしました。
コールドスタートの報告と app_launch_type の種別判定を修正:foreground(フォアグラウンド由来の起動)、background(バックグラウンド由来の起動)、foreground_and_background(フォアグラウンド由来の起動で、最初のフレーム前にバックグラウンドへ移行しフォアグラウンドに復帰)。
0.1.17 (2026/09/11)
setEnableConsoleLog(...) と @cloudcare/hvigor-ohos-plugin を追加し、console.* および hilog.* ログの自動収集をサポートします。Plugin を同時に導入し、ログ設定を有効にする必要があります。オプションの prefix パラメータは、通常のメッセージプレフィックスとしても、message、log_source および HiLog の tag、domain ごとに DataKit の許可ルールを設定するのにも使用できます。ログレベルは引き続き setLogLevelFilters(...) で制御され、ルールは自動ログが SDK キューに入る前に適用されます。
コンパイルプラグインによるコールドスタート収集を追加し、プロセス起動、AbilityStage 初期化、最初の UIAbility 作成、最初のフレームの所要時間を自動報告します。ライフサイクルを手動で記録する必要はありません。
FTRUMConfig.setResourceUrlHandler(...) を追加し、RCP、Axios および NetworkKit の自動 Resource のフィルタリングをサポートします。Trace Header の注入と手動 Resource には影響しません。
ファイルキャッシュ管理機能を追加し、総キャッシュ容量の制限、破棄戦略、FileStore の直接アップロードおよび旧キャッシュの移行をサポートします。
FTRUMConfig.setViewTrackingHandler(handler, type) を追加し、Router、Navigation またはすべての自動 View を対象に、フィルタリング、名前変更、属性追加をサポートします。ハンドラはソースページ情報を含む FTViewTrackingContext を受け取ります。
NetworkKit および @ohos/axios の Resource パフォーマンスタイミング収集とウォーターフォールチャートのフェーズマッピングを追加しました。パフォーマンスタイミングが欠落している場合、または最終時点が前のフェーズより早い場合は、実際に計測されたリクエスト総所要時間にフォールバックし、無効なフェーズが生成されないようにします。
FileStore の書き込み、容量統計、復旧診断機能を改善し、ファイルキャッシュとシャドウ書き込みのシナリオにおける安定性を向上させました。
リモートデータフィルタリングルールの更新メカニズムを最適化:アップロードタスクの開始時に pull_interval に従って更新を確認し、数値の間隔はナノ秒として解釈され、サーバー側の内容が変化していない場合は再処理しません。
自動 Resource が所属する Action のクローズ後に完了した場合、Resource/Error のカウントと Action の関連付けが失われる可能性がある問題を修正しました。
Action がクローズ済みの状態で Resource が完了した際に、View の Resource と処理待ちカウントが適時に更新されない問題を修正しました。
RCP Resource のウォーターフォールチャートで、First Byte とダウンロードフェーズが再構築された所要時間で計算され、転送フェーズの欠落やフェーズ所要時間の異常が発生する問題を修正しました。
タイムアウトや接続失敗など HTTP レスポンスを返さない Resource および関連する Network Error に resource_status=0 が欠落する問題を修正しました。
Worker で生成された Action、Resource、Error および Resource で生成された Network Error に、バインド済みのユーザーとネットワーク属性が欠落する問題を修正しました。
カスタム LineDataModifier の処理後に Action、Resource、Error および関連する Network Error が SDK の共通属性を失う問題を修正しました。
Axios および NetworkKit のリクエスト完了時にネットワーク状態が提供されないものの有効な所要時間が存在する場合、自動 Resource が破棄される可能性がある問題を修正しました。
0.1.16 (2026/08/31)
RUM デバイス指標の収集を追加し、setDeviceMetricsMonitorType(...) で View の CPU、メモリ、バッテリー電流、FPS を設定でき、setExtraMonitorTypeWithError(...) で Error に CPU、メモリ、バッテリー指標を追加できます。既存の setDeviceMetricsDetectFrequency(...) および単一引数の setDeviceMetricsMonitorType(...) 呼び出しは引き続き使用できます。
FTRUMConfig.setActionTrackingHandler(...) を追加し、自動 Click Action をフィルタリングできます。null を返すと収集をスキップし、undefined を返すとデフォルトの収集を維持します。
UI のカクつき(LongTask)の所要時間計算を修正し、システムの MAIN_THREAD_JANK イベントを使用するようにしました。
EventConsumer Worker の再起動後に RUM Action、Resource、Error で app_id が欠落することがある問題を修正し、データが設定済みの RUM アプリケーションに関連付けられるようにしました。
ネイティブおよび WebView Resource ならびにそれらが生成する Network Error の resource_id が安定した UUID を使用していない問題を修正し、関連付け検索を容易にしました。
リトライアップロード時に RUM データが重複して報告される可能性がある問題を修正し、元の sdk_data_id を保持して再利用します。
WebView データの補完ルールを変更:view_path_name を自動補完しないようにしました。view_referrer が欠落している場合は現在のネイティブ View にフォールバックします。
自動 Action のデフォルト名を コンポーネントタイプ/コンポーネントテキスト#コンポーネントID に変更しました。リストおよび Tab 内のコンポーネントには #position:n を追加します。
リモートデータフィルタリングルールを変更:setEnableDataFilter(true) を有効にし、有効な送信先アドレスを設定すると自動的に取得します。ルール更新時には該当するキャッシュデータをクリアします。
オフラインデータのアップロードを最適化:リトライを使い果たした後は外部トリガーを待機し、後続のアップロード可能なデータをブロックしません。
0.1.15 (2026/07/29)
DataModifier を追加し、Log、ネイティブ RUM、WebView RUM のフィールドとタグの変更またはマスキングをサポートします。フィールドコールバックが null を返した場合は元の値を保持します。
LineDataModifier による行レベルのデータパッチ機能を追加しました。コールバックはマージ後のデータを受け取り、返されたパッチに存在するフィールドのみを上書きします。null または空の Map を返した場合はデータを変更しません。
RUM および Logging データのフィルタリング機能を追加し、デフォルトで有効です。setEnableDataFilter(...) でスイッチを制御し、setDataFilters(...) でローカルルールを設定できます。ローカルルールとリモートルールが同時に適用され、ルールに一致したデータはローカルキャッシュに書き込まれません。
実行時の送信先アドレス切り替え機能を追加し、FTSDK.setDatakitUrl(...) または FTSDK.setDatawayUrl(..., clientToken) でアドレスを切り替えられます。切り替え後はリモート設定を自動的に更新し、DataWay モードではクライアント Token を提供する必要があります。
リモート設定機能を追加しました。起動時にローカルキャッシュとサポート済みの実行時更新項目をマージし、setRemoteConfiguration(...) で有効化でき、updateRemoteConfig(...) で手動更新できます。
RUM Action API を拡張:addAction は所要時間と拡張属性を設定でき、startAction は拡張属性を設定できます。
addActionWith...、startActionWith... および未完成の公開 stopAction API を削除しました。addAction、startAction に移行してください。
Resource ライフサイクルの拡張属性サポートを追加しました。startResource、stopResource の属性は呼び出し順に ResourceParams とマージされます。
公開 stopResource の未使用の statusCode と contentLength パラメータを削除しました。対応する呼び出しパラメータを削除してください。
addError のオーバーロード形式を変更しました。dateline は errorType の前に置くことができ、Worker コールバックは公開インターフェースではなくなりました。
0.1.14 (2026/07/17)
Error と Resource の収集経路を最適化し、通常の収集過程における高頻度の内部 Debug ログを削除しました。
アップロードリクエストの圧縮設定を追加し、setCompressIntakeRequests(...) で制御できます。デフォルトで deflate が有効になり、利用できない場合は平文アップロードにフォールバックします。
自動同期とアップロード制御の設定を追加し、FTSDKConfig.setAutoSync(...) で初期化状態を設定するか、FTSDK.setAutoSync(...) で実行時に同期状態を変更できます。デフォルトの自動アップロードは 10 秒の集約ウィンドウを使用し、オフにした場合や即時アップロードが必要な場合は FTSDK.flushSyncData() を呼び出せます。
同期ページング設定を追加し、setSyncPageSize(...) で定義済みのページングを設定するか、setCustomSyncPageSize(...) で同期件数をカスタマイズできます。
アップロードのネットワーク設定を追加し、setProxy(...)、setProxyAuthenticator(...)、setDns(...) でそれぞれプロキシ、プロキシ認証、DNS を設定できます。
スレッドプールとシリアルデータベースタスクの処理を最適化し、高並列シナリオにおけるデータの一貫性を向上させました。
ANR および Crash Worker のアイドル回収戦略を最適化し、Worker を必要に応じて再作成するようにしました。
Native Crash 診断ログの収集条件を変更:RUM App ID が設定され、FTRUMConfig.setEnableTrackAppCrash(true) が有効な場合にのみ収集します。
SDK デバッグ設定を追加し、FTSDKConfig.setSdkLogLevel(...) でログレベルを設定し、FTSDKConfig.setEnableInnerLogFile(...) で内部ログファイルに書き込めます。
FTTraceConfig.setTraceHeaderHandler(...) を追加し、単一リクエストにカスタム Trace コンテキストを提供して、SDK がリクエスト Header に注入し RUM Resource に関連付けられるようにしました。
RUM と Log のキャッシュ件数設定を変更:RUM のキャッシュ件数は FTRUMConfig.setRumCacheLimitCount(...) で設定するように変更し、Log のキャッシュ件数は引き続き FTLoggerConfig.setLogCacheLimitCount(...) を使用します。
共通エクスポートを変更:ルートディレクトリの Index から WebView 連携、高度な RCP インターセプターの組み立て、Trace インターセプターの型をエクスポートするようにし、内部パスからのインポートが不要になりました。
View データ確定時に動的属性(ユーザーデータを含む)が欠落する問題を修正しました。
ランダムに割り当てられるユーザー ID がまれに不安定になる問題を修正しました。
@ohos/axios 自動収集の互換パスを追加:interceptorChain をサポートしない axios バージョンでは applyFTAxiosTrack(...) を呼び出し、リクエストおよびレスポンスインターセプターを通じてデータを収集できます。
その他のログ
@cloudcare/hvigor-ohos-plugin
0.1.2
セッションリプレイの自動収集(実験的)を追加し、ArkUI の @Entry ページ、ArkWeb、タッチおよび Router のページ切り替えアニメーションをサポートします。HAP は ft_session_replay に依存し初期化を完了する必要があり、タッチ座標には TouchPrivacy.SHOW を設定する必要があります。デフォルトのシステムページ切り替えアニメーションはリプレイで差異が生じる場合があります。
console.*、hilog.* の自動収集によるビルド・実行エラーおよびログパラメータの欠落問題を修正しました。
UIAbility および InsightIntent エントリを継承した場合のコールドスタート収集を修正し、元のライフサイクルコールバックを保持します。AbilityStage が設定されていない場合は、近似の初期化所要時間を使用します。
自動収集のビルド診断ヒントを追加し、有効になっていないソースコードの位置と原因を特定できるようにしました。
自動収集をモジュール依存ごとに有効になるよう変更し、各収集対象モジュールは自身の oh-package.json5 の dependencies で対応する SDK を宣言する必要があります。同時に、マルチ HAP ビルド時に一部モジュールの収集が漏れる問題を修正しました。
console.*、hilog.* および最初のフレームのコールバックの計測コード生成を最適化し、前のステートメントにセミコロンがある場合に余分な前置セミコロンが追加されるのを防ぎます。
0.1.1 (2026/09/14)
コールドスタートと console.*、hilog.* の自動収集を同時に有効にした場合、コンソールログの計測が有効にならない可能性がある問題を修正しました。
0.1.0 (2026/09/14)
コンパイル時の計測を追加し、console.* および hilog.* ログの自動収集をサポートします。
コールドスタートのコンパイル時計測を追加し、コールドスタートの主要フェーズを自動記録します。
コールドスタートの最初のフレーム監視が WindowStage.loadContent(...) の完了前に登録に失敗する問題を修正し、読み込み成功後に自動的に再試行します。
その他のログ
ft_session_replay (実験的)
0.1.0-alpha04 (2026/11/02)
ArkUI、ArkWeb のセッションリプレイを追加し、テキスト、レイアウト、スクロール、コントロール操作、ページ切り替え、および画像、キャンバス、ImageAnimator、パターンロックの記録をサポートします。サポートされない画像ソースは必要に応じて手動で補完できます。ft_sdk 0.1.18-alpha04 以降と組み合わせる必要があり、ArkUI の自動収集には Hvigor プラグインの導入が必要です。詳細は連携説明 を参照してください。
録画サンプリングとエラー時の録画トリガーを追加し、setSampleRate(...)、setSessionReplayOnErrorSampleRate(...) は [0,100] のパーセントサンプリング値を使用します。エラートリガー録画はデフォルトでエラー前 1 分間のデータを保持します。
プライバシー制御を追加し、setTextAndInputPrivacy(...)、setImagePrivacy(...)、setTouchPrivacy(...)、setCaptureVisiblePassword(...) でテキスト、画像、タッチおよび可視パスワードの収集を制御します。デフォルトでは機密コンテンツを保護します。
RUM 関連付けとバージョン情報を追加し、enableLinkRUMKeys(...) でリプレイに含める RUM 情報を選択でき、初期化時に sdk_pkg_info.replay を通じて現在のモジュールバージョンを報告します。
録画制御とローカルキャッシュを追加し、setDelayInit(true)、start()、disable() で収集を制御します。disable() は新規収集を停止し、既存のキャッシュは定期アップロードまたは flush() 呼び出しによる即時アップロードが可能です。デフォルトではコア SDK の DataKit/DataWay アドレスを使用します。
その他のログ
ft_sdk_ext
0.1.18
NetworkKit HTTP インターセプターチェーンの networkErrorHandler 設定を追加し、グローバルハンドラーを上書きできます。コールバックが true を返した場合は Network Error のみをフィルタして Resource を保持し、null に設定した場合はグローバルハンドラーを使用しません。
NetworkKit および Axios のアップロードサイズ収集を追加し、実際のリクエストボディのバイト数を resource_request_size に補完します。Axios 収集の重複登録、およびリクエスト終了後に業務のアップロードコールバックが復元されない問題を修正しました。
NetworkKit のアップロード監視が適時にクリアされない問題、リダイレクト後の Resource 関連付けの異常、および SDK クローズ後も古いリクエストのコールバックを処理してしまう問題を修正しました。リクエストのキャンセルまたは破棄後に終了コールバックがない場合は、disposeFTHttpTrack(request) を呼び出して収集リソースを解放できます。
0.1.17 (2026/09/11)
NetworkKit のレスポンスパフォーマンスタイミング収集を追加し、Resource ウォーターフォールチャートに渡すようにしました。パフォーマンスタイミングが欠落または無効な場合は、実際のリクエスト総所要時間にフォールバックします。
NetworkKit インターセプターチェーンで HTTP レスポンスを返さない転送失敗が responseCode=0 の Resource のみを生成し、関連する Network Error が欠落する問題を修正しました。診断エラー情報を含む Resource と Network Error を同時に報告するようにし、呼び出し元の元の失敗結果は変更しません。
0.1.16 (2026/08/31)
ft_sdk_ext のバージョンを 0.1.16 に変更しました。バージョン整合のための更新であり、インターセプター API と動作に変更はありません。
0.1.15 (2026/07/29)
ft_sdk_ext のバージョンを 0.1.15 に変更しました。バージョン整合のための更新であり、インターセプター API と動作に変更はありません。
0.1.14 (2026/07/17)
NetworkKit インターセプターの統合方法を変更し、バージョン管理された FTSDKExtensionBridge 契約を使用することで、ft_sdk_ext が ft_sdk/src/main/... などの内部ソースパスに依存しないようにしました。
最小互換 API Level を 22 に変更しました。
NetworkKit HttpInterceptor API の配布方法を変更し、拡張 HAR に分割しました。この API を使用する場合は ft_sdk_ext を導入してください。
createFTHttpInterceptorChain(...) を追加し、NetworkKit の自動収集をサポートします。
applyFTHttpTrack(...) を追加し、HTTP 自動収集の導入をサポートします。
applyFTAxiosChainMethodBridge(...) を追加し、axios interceptorChain の自動収集をサポートします。
その他のログ
ft_native
0.1.3
Native Crash コールバックフィールド app_running_unique_id を追加し、同じクラッシュスタックに対応する異なるプロセス実行を区別できるようにしました。既存の連携に変更は不要です。
0.1.2 (2026/09/11)
Native Crash 監視の診断ログを最適化:正常パスにおける詳細な NAPI、シグナル処理、クラッシュ解析のログを Debug レベルに調整し、冗長なライフサイクルログを削除しました。収集 API と動作に変更はありません。
0.1.1 (2026/07/29)
ft_native のバージョンを 0.1.1 に変更しました。バージョン整合のための更新であり、Native Crash API と動作に変更はありません。
0.1.0 (2026/07/17)
独立した Native Crash 収集機能を追加しました。
Native Crash 収集ロジックを最適化:インストール済みの ft_sdk 依存関係に応じて自動的に適応し、実際のネイティブクラッシュのみを FTNativeCrashAdapter に渡します。JavaScript Crash は引き続き ft_sdk の Error 収集経路で処理され、重複報告を防ぎます。
その他のログ