독립 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 시간 기록 편차와 소요 시간이 0인 데이터 누락 문제를 수정했습니다.
대용량 데이터 업로드 전략을 변경하여 대용량 레코드는 전체를 개별 업로드하도록 했습니다. 이로써 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(포그라운드 소스로 시작했으나 첫 프레임 전에 백그라운드로 전환되었다가 포그라운드로 복귀).
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에 따라 업데이트를 확인하고, 숫자 간격은 나노초 단위로 해석하며, 서버 콘텐츠가 변경되지 않은 경우 중복 처리하지 않습니다.
소속 Action이 종료된 후 자동 Resource가 완료될 때 Resource/Error 카운트와 Action 연관 정보가 유실될 수 있는 문제를 수정했습니다.
Action이 이미 종료된 상태에서 Resource가 완료되었을 때 View의 Resource 및 대기 중인 카운트가 적시에 갱신되지 않는 문제를 수정했습니다.
RCP Resource 워터폴 차트의 첫 바이트와 다운로드 단계가 재구성된 소요 시간으로 계산되어 전송 단계가 누락되거나 단계 소요 시간이 비정상이 되는 문제를 수정했습니다.
타임아웃 및 연결 실패 등 HTTP 응답을 반환하지 않은 Resource와 연관 Network Error에 resource_status=0이 누락되는 문제를 수정했습니다.
Worker에서 생성된 Action, Resource, Error 및 Resource에서 생성된 Network Error에 바인딩된 사용자와 네트워크 속성이 누락되는 문제를 수정했습니다.
사용자 정의 LineDataModifier 처리 후 Action, Resource, Error 및 연관 Network Error에서 SDK 공통 속성이 유실되는 문제를 수정했습니다.
Axios 및 NetworkKit 요청이 완료될 때 네트워크 상태는 제공되지 않지만 유효한 소요 시간이 존재하는 경우 자동 Resource가 폐기될 수 있는 문제를 수정했습니다.
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)를 활성화하고 유효한 보고 주소를 설정하면 자동으로 가져옵니다. 규칙이 업데이트되면 해당되는 캐시 데이터를 정리합니다.
오프라인 데이터 업로드를 최적화했습니다: 재시도가 소진되면 외부 트리거를 대기하고, 이후 업로드 가능한 데이터를 차단하지 않습니다.
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 콜백은 더 이상 공개 인터페이스가 아닙니다.
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(...)를 호출하여 요청 및 응답 인터셉터로 데이터를 수집할 수 있습니다.
세션 리플레이 자동 수집(실험적)을 추가하여 ArkUI @Entry 페이지, ArkWeb, 터치 및 Router 페이지 전환 애니메이션을 지원합니다. HAP는 ft_session_replay에 의존하고 초기화를 완료해야 하며, 터치 좌표는 TouchPrivacy.SHOW로 설정해야 합니다. 기본 시스템 페이지 전환 애니메이션은 리플레이에서 차이가 있을 수 있습니다.
console.*, hilog.* 자동 수집으로 인한 빌드, 런타임 오류 및 로그 파라미터 누락 문제를 수정했습니다.
UIAbility 및 InsightIntent 진입점을 상속한 콜드 스타트 수집을 수정하여 기존 라이프사이클 콜백을 유지합니다. AbilityStage가 설정되지 않은 경우 근사 초기화 소요 시간을 사용합니다.
자동 수집 빌드 진단 힌트를 추가하여 적용되지 않은 소스 위치와 원인을 파악할 수 있습니다.
자동 수집이 모듈 의존성에 따라 적용되도록 변경했습니다. 수집 대상 모듈은 각자의 oh-package.json5dependencies에 해당 SDK를 선언해야 합니다. 또한 다중 HAP 빌드 시 일부 모듈이 수집되지 않는 문제를 수정했습니다.
console.*, hilog.* 및 첫 프레임 콜백의 계측 코드 생성을 최적화하여, 이전 구문에 이미 세미콜론이 있을 때 불필요한 선행 세미콜론이 추가되지 않도록 했습니다.
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 주소를 사용합니다.
NetworkKit HTTP 인터셉터 체인의 networkErrorHandler 설정을 추가하여 전역 핸들러를 재정의할 수 있습니다. 콜백이 true를 반환하면 Network Error만 필터링하고 Resource는 유지하며, null로 설정하면 전역 핸들러를 사용하지 않습니다.
NetworkKit 및 Axios 업로드 크기 수집을 추가하여 실제 요청 본문 바이트 수를 resource_request_size에 보완합니다. Axios 수집 중복 등록 및 요청 종료 후 비즈니스 업로드 콜백이 복원되지 않는 문제를 수정했습니다.
NetworkKit 업로드 리스너가 적시에 정리되지 않는 문제, 리다이렉트 후 Resource 연관 이상, 그리고 SDK 종료 후에도 이전 요청 콜백을 처리하는 문제를 수정했습니다. 요청 취소 또는 소멸 후 종료 콜백이 없을 때는 disposeFTHttpTrack(request)를 호출하여 수집 리소스를 해제할 수 있습니다.
NetworkKit 응답 성능 타이밍 수집을 추가하여 Resource 워터폴 차트로 전달합니다. 성능 타이밍이 누락되었거나 유효하지 않은 경우 실제 요청 총 소요 시간으로 대체합니다.
NetworkKit 인터셉터 체인에서 HTTP 응답을 반환하지 않은 전송 실패 시 responseCode=0 Resource만 생성되고 연관 Network Error가 누락되는 문제를 수정했습니다. 이제 진단 오류 정보를 포함한 Resource와 Network Error를 함께 보고하며, 호출자의 기존 실패 결과는 변경하지 않습니다.
Native Crash 수집 로직을 최적화했습니다. 설치된 ft_sdk 의존성에 따라 자동으로 적응하며, 실제 네이티브 크래시만 FTNativeCrashAdapter로 전달합니다. JavaScript Crash는 계속 ft_sdk의 Error 수집 경로에서 처리하여 중복 보고를 방지합니다.