변경 로그¶

1.6.7 (2026/08/19)¶

1. WebSocket 핸드셰이크 요청에 대한 RUM Resource 수집 지원이 추가되었습니다. 데이터에 resource_type=websocket, resource_websocket_collection_level=handshake, resource_websocket_handshake_state(success, rejected, failed) 필드가 추가되었습니다.
2. FTRumConfig.issueDataProvider가 추가되어, 자동 수집된 Crash 및 ANR RUM Error에 검증된 사용자 정의 필드와 이전 컨텍스트를 첨부할 수 있습니다.
3. macOS Session Replay 녹화 지원이 추가되어, 일반적인 AppKit 뷰 및 컨트롤을 포괄합니다.
4. macOS 애플리케이션 시작 Action 자동 수집이 추가되었으며, macOS 기본 service 및 Log source 태그가 통일되었습니다.
5. Session Replay 리소스 검사 및 업로드가 RUM 컨텍스트 연결을 지원합니다. FTSessionReplayConfig.enableLinkRUMKeys를 통해 전달할 RUM globalContext 필드를 선택하여, 동일한 리소스가 다른 연결 컨텍스트에서 올바르게 라우팅되고, 독립적으로 보존되며, 중복 제거되도록 보장합니다.
6. 폴백 View, 애플리케이션 시작, 첫 프레임 추적, 지연된 초기 Action, Session 만료 등의 시나리오에서 RUM 생명주기 처리가 최적화되었습니다.
7. UIKit 및 SwiftUI 자동 수집 RUM View의 loading_time 측정이 최적화되어, 사전 렌더링 및 사전 로드 단계의 유휴 시간이 제외되었습니다.

1.6.6 (2026/07/15)¶

1. 마이그레이션 변경 사항: CocoaPods 및 Swift Package Manager의 배포 제품이 FTMobileSDK 시리즈에서 GuanceSDK 시리즈로 변경되었습니다. GuanceSDK, GuanceWidgetExtension, GuanceSessionReplay를 사용하십시오. CocoaPods 별칭 GuanceSDK/Extension 및 GuanceSDK/FTSessionReplay는 계속 사용 가능합니다. 기존 프로젝트 업그레이드는 마이그레이션 가이드를 참조하십시오.
2. 실험적인 Session Replay 히트맵 연결 기능이 추가되었습니다. FTSessionReplayConfig.enableHeatmap을 통해 활성화할 수 있습니다. 이 기능은 자동 수집된 UIKit Action에만 연결되며, 일부 UIKit Action은 Heatmap을 지원하지 않을 수 있습니다. SwiftUI Action은 자동 수집을 지원하지 않으므로 이 기능을 통해 히트맵을 연결할 수 없습니다.
3. 시스템 compression 및 zlib 헤더 파일이 추가되었습니다.
4. URLSession Resource 안정성이 최적화되어, 비동기 처리에서 request 및 trace 데이터가 유지되고, 캐시된 응답 본문 크기가 제한되어 OOM 위험이 감소되었습니다.
5. RUM CPU 계산, 애플리케이션 시작, 애플리케이션 상태, Session 시간 초과, 크래시 컨텍스트 및 활성 View 컨텍스트 처리 문제가 수정되었습니다.
6. ANR 안정성이 향상되어, 애플리케이션이 백그라운드로 전환될 때 SQLite VACUUM이 실행되지 않도록 하고, 전체 스레드 역추적 수집이 재시도됩니다.
7. 잘못된 열거형 값으로 인한 잠재적인 배열 인덱스 초과 크래시가 수정되었습니다.

1.6.5 (2026/06/09)¶

1. Session Replay의 SwiftUI 녹화 기능을 명시적으로 활성화하기 위한 FTSessionReplayConfig.enableSwiftUI가 추가되었습니다. 기본값은 비활성화입니다.
2. iOS Session Replay Segment 업로드 시 사용자 정의 source 값을 지원하여 Flutter Session Replay 시나리오에 적응할 수 있도록 추가되었습니다.
3. 동적 UIColor 파싱으로 인한 Session Replay 크래시 문제가 수정되었고, 백그라운드 스냅샷 처리 및 SwiftUI 녹화 안정성이 최적화되었습니다.
4. 샘플링 상태 변경 후 Session Replay 데이터 캐시 처리가 최적화되었고, 잘못된 샘플링 적용 후 녹화가 시작되지 않는 문제가 수정되어 녹화 연속성과 안정성이 향상되었습니다.
5. Session Replay, RUM 및 Log 업로드 스케줄링과 재시도 처리가 최적화되었습니다.
6. Session Replay 렌더링 정확성과 성능이 최적화되었습니다. 여기에는 노드 평면화, 스냅샷 처리 큐 우선순위, View Tree 개인 정보 보호 오버라이드 상속 및 지원되지 않는 플레이스홀더 잘림이 포함됩니다.
7. RUM View 시간과 업로드 패킷 간의 일관성 문제가 수정되어, 이벤트 시간이 유지되고 package ID 생성 전에 View 데이터가 중복 제거됩니다.

1.6.4 (2026/05/21)¶

1. SwiftUI 뷰에 대한 Session Replay 지원이 추가되었습니다.
2. RUM SwiftUI 뷰 추적 및 수동 클릭 Action 추적 지원이 추가되었습니다.
3. 콜드 스타트 Action에 app_launch_type 필드가 추가되어 포그라운드 시작과 백그라운드 시작을 구분합니다.
4. FTMobileConfig.enableDataFilter 및 FTMobileConfig.dataFilters가 추가되어 SDK 측 DataFilter를 활성화하고 로컬 블랙리스트 규칙을 구성할 수 있습니다. DataFilter 규칙은 lineDataModifier 이후, 로컬 캐시 쓰기 이전에 실행됩니다.
5. 업로드 Worker 종료 격리, 업로드 콜백 동기화 및 RUM 업로드 동작이 최적화되어 중복 업로드, 만료된 재시도 루프, 업로드 실행 충돌을 방지하고 업로드 시 중복 View 데이터를 건너뜁니다.
6. RUM 플레이스홀더 View 처리가 폴백 View 해석으로 대체되어, 원래 View를 사용할 수 없을 때 View 추적 일관성이 향상되었습니다.
7. nil, 빈 값 및 사용자 정보 업데이트 시나리오에서 사전 설정 속성 Tag 처리가 최적화되었습니다.

1.6.3 (2026/04/30)¶

1. RUM View의 페이지 정지율을 통계하기 위한 view_long_task_rate가 추가되었습니다.
2. RUM Resource 데이터에 network_available 필드가 추가되어 리소스 시작 시의 네트워크 가용성 상태 스냅샷을 기록합니다.
3. RUM 크래시 데이터에 애플리케이션 상태 통계의 크래시 지속 시간 필드인 foreground_crash_free_duration 및 background_crash_free_duration이 추가되었습니다.
4. Session Replay 리소스 업로드에 연결된 RUM Key 지원이 추가되었습니다.
5. 데이터 업로드 요청 압축이 기본적으로 활성화됩니다.
6. 긴 작업 감지기에서 NSDate의 경합 상태 문제가 수정되었습니다.
7. WKWebView bridge 잠금 및 중복 활성화 처리 문제가 수정되어 WebView RUM/Session Replay 안정성이 향상되었습니다.
8. Session Replay가 WebView 노드 데이터를 처리할 때 로컬 CSS 주입이 실패할 수 있는 문제가 수정되었습니다.

1.6.2 (2026/04/17)¶

1. Session Replay 기능이 추가되어 WebView Session Replay를 지원합니다.
2. Session Replay와 RUM 컨텍스트 연결 기능이 추가되어, WebView 컨테이너와 로드된 HTML 콘텐츠의 컨텍스트를 연결할 수 있습니다.
3. Session Replay 오류 샘플링 기능이 추가되었고, 원격 구성을 통해 Session Replay를 동적으로 제어할 수 있습니다.
4. Session Replay 이미지 리소스 업로드 기능이 추가되었습니다.
5. Session Replay는 touchPrivacy, textAndInputPrivacy, imagePrivacy를 통해 터치, 텍스트 및 입력, 이미지의 개인 정보 보호 구성을 지원하며, sessionReplayPrivacyOverrides를 통해 개별 UIView에 대한 뷰 수준 개인 정보 보호 오버라이드를 지원합니다.

1.5.21 (2026/04/15)¶

1. setDatakitURL:, setDatawayURL:clientToken: 메서드가 추가되어 런타임에 동적으로 업로드 주소를 업데이트할 수 있습니다.
2. 최소 배포 버전이 iOS 12+, macOS 10.14+로 조정되었습니다.
3. addAction: 호출 시 View 연결 실패 문제가 수정되었습니다.
4. Log와 RUM 연결 로직이 최적화되어 누락된 action_id 필드가 보완되었습니다.
5. RemoteConfig 가져오기 간격 로직이 수정되어, SDK 시작 시 로컬의 마지막 요청 시간을 사용하여 요청 간격을 확인합니다.
6. 샘플링 속도 동적 수정이 적용되지 않는 문제가 수정되었습니다.

1.5.20 (2026/02/26)¶

1. FTPresetProperty의 동시 읽기/쓰기 문제가 수정되어, 딕셔너리 손상 및 중복 해제로 인한 크래시를 방지합니다.
2. SDK 내 SQLite가 WAL 모드를 활성화합니다.
3. 더 이상 사용되지 않는 SCNetworkReachability가 NWPathMonitor로 대체되었습니다.
4. 더 이상 사용되지 않는 API UIScreen.mainScreen 사용이 제거되었습니다.
5. FTMobileConfig.dataModifier 처리 로직이 수정되어 모든 데이터 항목을 포괄합니다.

1.5.19 (2026/01/09)¶

1. resource_type이 확장되어 image, media, font, CSS, JS, native 유형이 추가되었습니다.
2. 네트워크 오류에 resource_id가 추가되어 해당 리소스 데이터를 연결할 수 있습니다.
3. FTMobileConfig.remoteConfigFetchCompletionBlock 또는 +updateRemoteConfigWithMiniUpdateInterval:completion: 메서드 콜백을 통해 원격 변수의 사용자 정의 파싱 및 구성을 지원합니다.
4. Resource에 resource_http_protocol, resource_request_size, resource_connection_reuse 필드가 추가되었습니다.
5. 콜드 스타트 및 웜 스타트 시간 지표가 세분화되어 app_pre_runtime_init_time, app_runtime_init_time, app_uikit_init_time, app_application_init_time, app_first_frame_init_time이 추가되었습니다.
6. RUM View 누락으로 인한 데이터 손실 문제가 수정되었습니다.
7. 크래시 및 ANR 스택 기능이 강화되어 전체 스레드 정보 수집을 지원하며, FTRumConfig.crashMonitoring을 통해 크래시 모니터링 유형을 설정할 수 있습니다.

1.5.18 (2025/08/08)¶

1. FTRumConfig.viewTrackingHandler 및 FTRumConfig.actionTrackingHandler를 통한 RUM View/Action 수집 필터링, 사용자 정의 View/Action 이름 지정이 지원됩니다.
2. -updateViewLoadingTime: 메서드가 추가되어 현재 활성 RUM View의 로딩 시간을 업데이트할 수 있습니다.
3. 로그 데이터에서 sdk_name 필드 누락 문제가 수정되었습니다.
4. WebView 데이터 수집 시 UserScripts 충돌 문제가 수정되었습니다.
5. SDK 종료 작업의 스레드 안전성 문제가 수정되었습니다.
6. Long task 모니터링 중 메인 스레드 이름 수정으로 인한 크래시 문제가 수정되었습니다.
7. FTRumConfig.h/.m 파일이 추가되어 FTRumConfig가 FTMobileConfig.h에서 별도 파일로 분리되었습니다.

1.5.17 (2025/06/11)¶

1. SDK를 통한 webview 데이터 수집 활성화 여부를 구성하는 FTRUMConfig.enableTraceWebView가 추가되었습니다. FTRUMConfig.allowWebViewHost를 통해 필터링할 호스트 주소를 제어할 수 있습니다.
2. 로컬 네트워크 오류를 필터링할 수 있는 FTRumConfig.sessionTaskErrorFilter가 추가되었습니다.
3. 원격 조건 구성 기능을 활성화하는 FTMobileConfig.remoteConfiguration과 원격 제어 활성화 후 최소 업데이트 간격을 설정하는 FTMobileConfig.remoteConfigMiniUpdateInterval이 추가되었습니다.

1.5.16 (2025/05/16)¶

1. 데이터 쓰기 대체 및 데이터 마스킹을 지원하는 FTMobileConfig.lineDataModifier, FTMobileConfig.dataModifier가 추가되었습니다.
2. 오류 샘플링을 지원하는 FTRUMConfig.sessionErrorSampleRate가 추가되어, sampleRate에 의해 샘플링되지 않은 경우 오류 발생 시 1분 전의 RUM 데이터를 샘플링하여 수집할 수 있습니다.
3. Logger가 logLevelFilter를 통해 사용자 정의 로그 레벨 필터링을 지원합니다.
4. 네이티브 페이지에서 WebView 페이지로 전환 시, 네이티브 페이지 이름으로 view_referrer가 채워집니다.

1.5.15 (2025/04/14)¶

1. Swift Package Manager 컴파일 오류 문제가 수정되었습니다.

1.5.14 (2025/03/07)¶

1. RUM Resource 데이터 필드 resource_first_byte_time, resource_dns_time, resource_download_time, resource_connect_time, resource_ssl_time, resource_redirect_time가 추가되어 Guance에서 Resource 소요 시간 강화 표시를 지원하고, APM 플레임 그래프에서 시간 축 정렬을 지원합니다.
2. FTMobileConfig.enableDataIntegerCompatible이 기본적으로 활성화됩니다.
3. 매크로 정의 FT_DISABLE_SWIZZLING_RESOURCE를 통해 SDK 내 URLSession Method Swizzling 메서드를 비활성화할 수 있습니다.
4. 데이터 동기화가 최적화되어 실패 시 재전송 로직이 추가되었습니다.

1.5.13 (2025/02/27)¶

1. 페이지 수집 로직이 최적화되어 특수 뷰로 인한 RUM View 수집 누락을 방지합니다.

1.5.12 (2025/02/10)¶

1. 파일 저장 경로 구성이 조정되어 tvOS 환경에서 데이터베이스 생성 실패 문제가 수정되었습니다.
2. tvOS 환경의 기본 service 및 로그 source가 각각 df_rum_tvos 및 df_rum_tvos_log로 업데이트되었습니다.
3. RUM Action 이벤트에서 duration 시간 계산이 정확하지 않은 문제가 수정되었습니다.

1.5.11 (2025/02/05)¶

1. RUM Resource 수집이 최적화되어, RUM Resource 자동 수집 활성화 시 SDK 내 요청이 수집되지 않도록 방지합니다.
2. Widget Extension에서 skyWalking 유형 분산 추적 실패 문제가 수정되었습니다.

1.5.10 (2025/01/21)¶

1. FTTraceConfig.traceInterceptor를 통한 Request 가로채기 사용자 정의 Trace, FTRumConfig.resourcePropertyProvider를 통한 RUM Resource 사용자 정의 속성 추가를 지원합니다.
2. 다중 스레드 액세스 시 동적 전역 속성 추가 메서드의 비정상적인 문제가 수정되었습니다.
3. WebView 전달 데이터 정보가 최적화되었습니다.

1.5.9 (2025/01/08)¶

1. FTURLSessionDelegate.traceInterceptor block을 통한 URLRequest 가로채기, 사용자 정의 분산 추적, spanId 및 traceId 변경이 지원됩니다.
2. RUM Resource가 swift async/await URLSession API를 통해 시작된 네트워크 요청 수집을 지원합니다.
3. LongTask 및 Anr 연결 View 오류 문제가 수정되었습니다.

1.5.8 (2024/12/23)¶

1. tvOS 지원이 추가되었습니다.
2. FTRUMConfig.rumCacheLimitCount를 통해 RUM 최대 캐시 항목 수를 제한할 수 있습니다. FTRUMConfig.rumDiscardType을 통해 폐기 전략을 설정할 수 있습니다.
3. FTMobileConfig.enableLimitWithDbSize를 통해 총 캐시 크기 제한 기능을 지원합니다. 활성화 시 FTLoggerConfig.logCacheLimitCount 및 FTRUMConfig.rumCacheLimitCount는 무효화됩니다. FTMobileConfig.dbDiscardType을 통해 db 폐기 전략을, FTMobileConfig.dbCacheLimit을 통해 db 캐시 제한 크기를 설정할 수 있습니다.

1.5.7 (2024/12/04)¶

1. FTRUMConfig.freezeDurationMs를 통해 정지 감지 임계값을 설정할 수 있습니다.
2. SDK의 shutDown 메서드가 최적화되어 메인 스레드 동기 대기로 인한 정지 또는 WatchDog 크래시를 방지합니다.

1.5.6 (2024/11/13)¶

1. FTMobileConfig.compressIntakeRequests를 사용하여 동기화 데이터에 대한 deflate 압축 구성을 지원합니다.
2. RUM에 addAction:actionType:property 및 startAction:actionType:property: 메서드가 추가되어, RUM Action 수집 로직이 최적화되었습니다.
3. NSFileHandle의 더 이상 사용되지 않는 api 사용으로 인한 크래시 문제가 수정되었습니다.

1.5.5 (2024/11/06)¶

1. FTResourceMetricsModel에서 배열 인덱스 초과로 인한 크래시 문제가 수정되었습니다.

1.5.4 (2024/10/18)¶

1. 전역, log, RUM globalContext 속성 동적 설정 방식이 추가되었습니다.
2. 데이터 삭제 메서드가 추가되어 아직 서버에 업로드되지 않은 모든 데이터를 삭제할 수 있습니다.
3. 동기화 간격이 지원하는 최대 시간 간격이 5000밀리초로 조정되었습니다.

1.5.3 (2024/10/09)¶

1. LongTask, Anr 수집 시 속성 수식자 오류 사용으로 인한 메모리 액세스 오류 크래시가 수정되었습니다.
2. FTSwizzler의 메서드 시그니처 검증 assertion이 내부 경고 로그로 대체되었습니다.
3. 수집 데이터의 소수점 정밀도가 최적화되었습니다.

1.5.2 (2024/08/21)¶

1. Xcode 16 컴파일 시 #include <arm/_mcontext.h> 헤더 파일 누락 문제가 수정되었습니다.
2. RUM-Resource 자동 수집 시, 로컬 캐시에서 직접 가져오거나 유형을 알 수 없는 Resource가 필터링되어 중복 수집을 방지합니다.
3. UITabBarController 하위 뷰의 loadingTime 계산 로직이 수정되었습니다.

1.5.1 (2024/08/02)¶

1. 줄 프로토콜 데이터 이스케이프 알고리즘이 수정되어, 줄바꿈 문자로 인한 데이터 동기화 실패 문제가 해결되었습니다.
2. network_error 유형의 오류 메시지가 최적화되어, 네트워크 요청 오류 코드 설명이 영어로 통일되었습니다.
3. 데이터 동기화 로직이 최적화되어, 다중 스레드에서 이미 해제된 uploadDelayTimer에 접근하여 발생하는 크래시 문제가 수정되었습니다.
4. 크래시 정보 수집 시 OC와 C 문자열 변환 중 인코딩 형식 오류로 인한 크래시 문제가 수정되었습니다.

1.5.0 (2024/06/03)¶

1. RUM resource 네트워크 요청에 remote ip 주소 해석 기능이 추가되었습니다.
2. 웹 데이터 유형 충돌 문제를 처리하기 위한 줄 프로토콜 Integer 데이터 호환 모드가 추가되었습니다.
3. 로그에 사용자 정의 status 메서드가 추가되었습니다.
4. 로그 데이터 쓰기 최적화, 데이터 동기화 최적화가 이루어졌습니다.
5. SDK에 전달되는 NSDictionary 유형 매개변수의 형식이 처리되어 json 변환 실패로 인한 데이터 손실을 방지합니다.

1.4.14 (2024/05/29)¶

1. FTSwizzler 내에서 이미 소멸된 Class 객체에 접근하여 발생하는 메모리 액세스 오류 크래시가 수정되었습니다.
2. SDK에 전달되는 NSDictionary 유형 매개변수가 실제로 가변 객체일 때 발생할 수 있는 데이터 일관성 및 작업 충돌 문제가 수정되었습니다.

1.4.13 (2024/05/15)¶

1. RUM LongTask, Anr 수집이 최적화되어 LongTask 스택 정보 수집 부정확 문제가 수정되었고, 치명적인 정지 수집 지원이 추가되었습니다.
2. FTSwizzler 내에서 다중 스레드가 동시에 NSMutableSet을 조작하여 발생하는 크래시가 수정되었습니다.
3. SDK Framework info.plist에 버전 정보 누락 문제가 수정되었습니다.
4. 사용자 정의 NSURLSession에 delegate가 설정되지 않았을 때 Resource 성능 지표 수집 실패 문제가 수정되었습니다.
5. SDK 내부 로그를 파일로 변환하는 기능이 최적화되어, 특정 파일 경로 지정 메서드가 추가되었습니다.

1.4.12 (2024/04/26)¶

1. SDK 종료 메서드 shutDown 호출 시 발생하는 메모리 누수 문제가 수정되었습니다.
2. RUM-Resource 수집 시 다른 라이브러리와의 충돌로 인한 크래시 문제가 수정되었습니다.
3. 크래시 수집 UncaughtExceptionHandler 미전달 문제가 수정되었습니다.
4. SDK를 여러 번 초기화하여 발생하는 데이터 이상 문제가 수정되었습니다.

1.4.11(2024/03/28)¶

1. 데이터 동기화 매개변수 구성(요청 항목 데이터, 동기화 간격 시간, 로그 캐시 항목 수) 지원이 추가되었습니다.
2. 내부 로그를 파일로 변환하는 메서드가 추가되었습니다.
3. 로그 연결 RUM 데이터 획득 오류가 수정되었습니다.
4. 시간 소요 작업이 최적화되었습니다.
5. WebView jsBridge 시 발생하는 크래시가 수정되어, WebView 참조가 약한 참조로 변경되었습니다.

더 많은 로그