콘텐츠로 이동

RUM 설정

RUM 초기화 설정

    // RUM 활성화
    FTRumConfig *rumConfig = [[FTRumConfig alloc]initWithAppid:appid];
    rumConfig.enableTraceUserView = YES;
    rumConfig.deviceMetricsMonitorType = FTDeviceMetricsMonitorAll;
    rumConfig.monitorFrequency = FTMonitorFrequencyRare;
    rumConfig.enableTraceUserAction = YES;
    rumConfig.enableTraceUserResource = YES;
    rumConfig.enableTrackAppFreeze = YES;
    rumConfig.enableTrackAppCrash = YES;
    rumConfig.enableTrackAppANR = YES;
    rumConfig.errorMonitorType = FTErrorMonitorAll;
    [[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];
    let rumConfig = FTRumConfig(appid: appid)
    rumConfig.enableTraceUserView = true
    rumConfig.deviceMetricsMonitorType = .all
    rumConfig.monitorFrequency = .rare
    rumConfig.enableTraceUserAction = true
    rumConfig.enableTraceUserResource = true
    rumConfig.enableTrackAppFreeze = true
    rumConfig.enableTrackAppCrash = true
    rumConfig.enableTrackAppANR = true
    rumConfig.errorMonitorType = .all
    FTMobileAgent.sharedInstance().startRum(withConfigOptions: rumConfig)
속성 유형 필수 의미
appid NSString 예 RUM 앱 ID의 고유 식별자입니다. 해당 RUM appid를 설정해야 RUM의 수집 기능이 활성화되며, appid 가져오기 방법
sessionSamplingRate float 아니요 RUM 세션 샘플링 비율로, 범위는 [0,100]이며 소수점을 지원합니다. 기본값은 100입니다. 0.1은 0.1%, 1은 1%를 의미합니다. 동일한 세션 내의 RUM 데이터에 적용됩니다. SDK 1.6.8부터 지원합니다.
sampleRate int 아니요 SDK 1.6.8부터 폐기되었으며 호환성을 위해 유지됩니다. 정수 백분율 샘플링 비율로, 범위는 [0,100]이며 기본값은 100입니다. sessionSamplingRate 사용을 권장합니다.
sessionOnErrorSamplingRate float 아니요 정상 세션 샘플링에 포함되지 않은 경우 오류 보완 샘플링 비율로, 범위는 [0,100]이며 소수점을 지원합니다. 기본값은 0입니다. 동일한 세션의 RUM 데이터에 적용됩니다. SDK 1.6.8부터 지원합니다.
sessionOnErrorSampleRate int 아니요 SDK 1.6.8부터 폐기되었으며 호환성을 위해 유지됩니다. 정수 백분율 오류 보완 샘플링 설정으로, 범위는 [0,100]이며 기본값은 0입니다. sessionOnErrorSamplingRate 사용을 권장합니다.
enableTrackAppCrash BOOL 아니요 충돌 로그 수집 필요 여부를 설정합니다. 기본값 NO
enableTrackAppANR BOOL 아니요 ANR 지연 및 무응답 이벤트를 수집합니다. 기본값 NO
enableTrackAppFreeze BOOL 아니요 UI 버벅임 이벤트를 수집합니다. 기본값 NO입니다. -setEnableTrackAppFreeze:freezeDurationMs: 메서드를 통해 버벅임 수집을 활성화하고 버벅임 임계값을 설정할 수 있습니다
freezeDurationMs long 아니요 UI 버벅임 임계값을 설정합니다. 값 범위는 [100,)이고 단위는 밀리초이며 기본값은 250ms입니다. SDK 1.5.7 이상에서 지원합니다
enableTraceUserView BOOL 아니요 사용자 View 작업 추적 여부를 설정합니다. 기본값 NO
enableTraceUserViewLoadingTime BOOL 아니요 SDK 1.6.9부터 지원합니다. 페이지 loading_time 자동 수집 여부이며 기본값은 YES이고 enableTraceUserView = YES일 때 적용됩니다. NO로 설정해도 RUM View 추적은 유지됩니다. RUM 시작 전에 설정해야 하며, 자세한 내용은 수집 제어를 참조하세요
viewLoadingTimeClassNameExcludes NSArray<NSString *> 아니요 SDK 1.6.9부터 지원합니다. 페이지 로딩 소요 시간을 자동 수집하지 않을 컨트롤러의 전체 런타임 클래스 이름 배열이며 기본값은 빈 배열입니다. 대소문자를 구분하여 정확히 일치하는지 확인하며, 부분 문자열, 정규식 또는 상속 관계로 일치 여부를 판단하지 않고 사용자 정의 View Name도 사용하지 않습니다. 일치하더라도 RUM View 추적은 유지되며, RUM 시작 전에 설정해야 합니다. 자세한 내용은 수집 제어를 참조하세요
enableTraceUserAction BOOL 아니요 사용자 Action 동작 추적 여부를 설정합니다. 기본값 NO입니다. view.accessibilityIdentifier를 통해 action_name을 사용자 정의할 수 있습니다
launchPrewarmInterval NSInteger 아니요 SDK 1.6.9부터 지원하며 iOS에만 적용됩니다. 사전 워밍 인식 임계값을 사용자 정의합니다. 단위는 밀리초이고 기본값은 0(비활성화)이며, 필요에 따라 1500 설정을 권장합니다. enableTraceUserAction이 활성화되어 있어야 합니다. 시스템 사전 워밍 인식 및 트리밍은 항상 적용됩니다. 자세한 내용은 시작 사전 워밍 인식을 참조하세요
enableTraceUserResource BOOL 아니요 사용자 네트워크 요청 추적 여부를 설정합니다. 기본값은 NO이며 네이티브 HTTP에만 적용됩니다. 참고: [NSURLSession sharedSession]을 통해 시작된 네트워크 요청은 성능 데이터를 수집할 수 없습니다. SDK 1.5.9 이상에서는 Swift의 URLSession async/await APIs를 통해 시작된 네트워크 요청의 수집을 지원합니다
enableTraceURLConnectionResource BOOL 아니요 SDK 1.6.8+: NSURLConnection RUM Resource를 자동 수집하며 기본값은 NO입니다. URLSession을 제어하는 enableTraceUserResource와 독립적입니다. 예시는 NSURLConnection 수집을 참조하세요
visitorIDConfig FTVisitorIDConfig 아니요 SDK 1.6.8+: 익명 방문자 식별자(Visitor ID) 설정이며 기본값은 nil(비활성화)입니다. 자세한 내용은 방문자 식별자 Visitor ID를 참조하세요
nextViewActionPredicate id<FTRUMNextViewActionPredicate> 아니요 SDK 1.6.8+: INV Action 일치 규칙이며 기본값은 click이고 간격은 3초를 초과하지 않습니다. 명시적으로 nil로 설정하면 INV가 비활성화되며 App Extension은 지원하지 않습니다. 자세한 내용은 View 시간 지표를 참조하세요
networkSettledResourcePredicate id<FTRUMNetworkSettledResourcePredicate> 아니요 SDK 1.6.8+: TNS 초기 요청 일치 규칙이며 기본적으로 요청은 View 시작 후 [0,100ms]에 시작됩니다. nil로 설정하면 기본 규칙으로 복원됩니다. 자세한 내용은 View 시간 지표를 참조하세요
resourceUrlHandler FTResourceUrlHandler 아니요 resource 수집 규칙을 사용자 정의합니다. 기본적으로 필터링하지 않습니다. NO를 반환하면 수집하고, YES를 반환하면 수집하지 않습니다
errorMonitorType FTErrorMonitorType 아니요 오류 이벤트 모니터링 보완 유형입니다. 수집된 충돌 데이터에 모니터링 정보를 추가합니다. FTErrorMonitorBattery는 배터리 잔량, FTErrorMonitorMemory는 메모리 사용량, FTErrorMonitorCpu는 CPU 점유율이며 기본값은 설정되지 않습니다
deviceMetricsMonitorType FTDeviceMetricsMonitorType 아니요 View의 성능 모니터링 유형이며 기본값은 설정되지 않습니다. 수집된 View 데이터에 해당 모니터링 항목 정보를 추가합니다. FTDeviceMetricsMonitorMemory는 현재 앱의 메모리 사용량을 모니터링하고, FTDeviceMetricsMonitorCpu는 CPU 변동 횟수를 모니터링하며, FTDeviceMetricsMonitorFps는 화면 프레임률을 모니터링합니다
monitorFrequency FTMonitorFrequency 아니요 View의 성능 모니터링 샘플링 주기입니다. FTMonitorFrequencyDefault 500ms(기본값), FTMonitorFrequencyFrequent 100ms, FTMonitorFrequencyRare 1000ms
enableResourceHostIP BOOL 아니요 요청 대상 도메인 주소의 IP 수집 여부입니다. >= iOS 13.0, >= tvOS 13.0에서 지원됩니다
globalContext NSDictionary 아니요 사용자 정의 태그를 추가하여 RUM 데이터 소스를 구분하는 데 사용합니다. 추적 기능을 사용하려면 매개변수 key는 track_id, value는 임의의 숫자 값이어야 합니다. 추가 규칙은 여기를 참조하세요
rumCacheLimitCount int 아니요 RUM 최대 캐시량입니다. 기본값은 100_000이며 SDK 1.5.8 이상에서 이 매개변수를 지원합니다
rumDiscardType FTRUMCacheDiscard 아니요 RUM 폐기 규칙을 설정합니다. 기본값은 FTRUMCacheDiscard입니다. FTRUMCacheDiscard는 RUM 데이터 수가 최대값보다 클 때 추가 데이터를 폐기하고, FTRUMDiscardOldest는 RUM 데이터가 최대값보다 클 때 오래된 데이터를 폐기합니다. SDK 1.5.8 이상에서 이 매개변수를 지원합니다
resourcePropertyProvider FTResourcePropertyProvider 아니요 block 콜백을 통해 RUM Resource 사용자 정의 속성을 추가합니다. SDK 1.5.10 이상에서 이 매개변수를 지원합니다. 우선순위는 URLSession 사용자 정의 수집보다 낮습니다
enableTraceWebView BOOL 아니요 WebView 데이터 수집 활성화 여부를 설정하며 기본값은 YES입니다. SDK 1.5.17 이상에서 지원합니다
allowWebViewHost NSArray 아니요 SDK 1.6.8부터 폐기되었으며, 새 코드에서는 FTSDKConfig.allowWebViewHost에서 통합 WebView 허용 목록을 설정합니다. 기존 설정은 호환성을 위한 폴백으로 계속 사용되며, 우선순위는 WebView 데이터 모니터링을 참조하세요
sessionTaskErrorFilter FTSessionTaskErrorFilter 아니요 URLSessionTask Error 차단 여부를 설정합니다. 차단하려면 YES, 차단하지 않으려면 NO를 반환하며, 차단하면 RUM-Error에서 해당 오류를 수집하지 않습니다. SDK 1.5.17 이상에서 지원합니다
issueDataProvider FTIssueDataProvider 아니요 SDK가 자동 수집하는 Crash 및 ANR RUM Error에 사용자 정의 필드를 동기적으로 추가합니다. enableTrackAppCrash 또는 enableTrackAppANR을 각각 활성화해야 하며 SDK 1.6.7 이상에서 지원합니다. 사용 방법은 Error 사용자 정의 필드를 참조하세요
viewTrackingHandler FTViewTrackingHandler 아니요 View 추적 로직을 사용자 정의하여 어떤 ViewController를 RUM View로 모니터링할지 결정하고 View Name을 사용자 정의합니다. 적용 조건: enableTraceUserView = YES. SDK 1.5.18 이상에서 지원하며, 사용 예시는 여기를 참조하세요
swiftUIViewTrackingHandler FTSwiftUIViewTrackingHandler 아니요 실험적. SwiftUI View 자동 수집 로직을 사용자 정의하여 자동 추출된 SwiftUI View Name을 필터링하고 RUM View Name을 사용자 정의합니다. 적용 조건: enableTraceUserView = YES이며 해당 설정이 비어 있지 않아야 합니다. 사용자 정의 필터링이나 이름 지정이 필요하지 않으면 FTDefaultSwiftUIViewTrackingHandler를 설정할 수 있습니다. 이 실험적 API는 이후 버전에서 조정될 수 있으며 SDK 1.6.4 이상에서 지원합니다. 사용 예시는 여기를 참조하세요
actionTrackingHandler FTActionTrackingHandler 아니요 Action 추적 로직을 사용자 정의하여 기록할 RUM Action 이벤트를 필터링하고 Action Name을 사용자 정의합니다. 적용 조건: enableTraceUserAction = YES. SDK 1.5.18 이상에서 지원하며, 사용 예시는 여기를 참조하세요
crashMonitoring FTCrashMonitorType 아니요 SDK 충돌 모니터링의 유형 범위를 설정하며 기본값은 FTCrashMonitorTypeHighCompatibility(고호환성 모드 사전 설정 매크로)입니다. 적용 조건: enableTrackAppCrash = YES. 참고: FTCrashMonitorTypeSystem | FTCrashMonitorTypeApplicationState를 지정해야 하며, 이는 보고서에 중요한 정보를 제공할 수 있습니다. SDK 1.5.19 이상에서 지원합니다
샘플링 비율 매개변수 이름

SDK 1.6.8 이상에서는 sessionSamplingRate 사용을 권장합니다. 값은 0~100의 백분율이며 소수점을 지원합니다. 유효하지 않은 값(범위 초과, NaN, 무한대)은 기존 설정을 덮어쓰지 않습니다. 이전 sampleRate / samplerate는 정수 백분율만 지원하며 폐기된 것으로 표시되었고 향후 버전에서 제거될 수 있습니다. 이전 getter로 소수 샘플링 비율을 읽으면 정수 부분이 반환됩니다.

원격 샘플링 필드의 단위와 우선순위는 원격 설정 필드를 참조하세요.

RUM 사용자 데이터 추적

FTRUMConfig에서 enableTraceUserAction, enableTraceUserView, enableTraceUserResource, enableTrackAppFreeze, enableTrackAppCrash, enableTrackAppANR을 설정하면 Action, View, Resource, LongTask, Error 데이터의 자동 수집 추적을 통해 데이터를 얻을 수 있습니다. 사용자 정의 수집을 원하면 FTExternalDataManager를 통해 데이터를 보고할 수 있습니다.

View

사용 방법

/// 페이지 생성
///
/// `-startViewWithName` 메서드 전에 호출합니다. 이 메서드는 페이지 로딩 시간을 기록하는 데 사용되며, 로딩 시간을 얻을 수 없으면 호출하지 않아도 됩니다.
/// - Parameters:
///  - viewName: 페이지 이름
///  - loadTime: 페이지 로딩 시간(나노초)
-(void)onCreateView:(NSString *)viewName loadTime:(NSNumber *)loadTime;

/// 페이지 진입
/// - Parameters:
///  - viewName: 페이지 이름
///  - property: 이벤트 사용자 정의 속성(선택 사항)
-(void)startViewWithName:(NSString *)viewName property:(nullable NSDictionary *)property;

/// 현재 RUM View의 로딩 시간을 업데이트합니다.
/// `-startView`와 `-stopView` 메서드 사이에서 호출해야 적용됩니다.
/// - Parameter duration: 로딩 시간(나노초).
-(void)updateViewLoadingTime:(NSNumber *)duration;

/// 페이지 이탈
/// - Parameter property: 이벤트 사용자 정의 속성(선택 사항)
-(void)stopViewWithProperty:(nullable NSDictionary *)property;
/// 페이지 생성
///
/// `-startViewWithName` 메서드 전에 호출합니다. 이 메서드는 페이지 로딩 시간을 기록하는 데 사용되며, 로딩 시간을 얻을 수 없으면 호출하지 않아도 됩니다.
/// - Parameters:
///  - viewName: 페이지 이름
///  - loadTime: 페이지 로딩 시간(ns)
open func onCreateView(_ viewName: String, loadTime: NSNumber)

/// 페이지 진입
/// - Parameters:
///  - viewName: 페이지 이름
///  - property: 이벤트 사용자 정의 속성(선택 사항)
open func startView(withName viewName: String, property: [AnyHashable : Any]?)

/// 현재 RUM View의 로딩 시간을 업데이트합니다.
/// `-startView`와 `-stopView` 메서드 사이에서 호출해야 적용됩니다.
/// - Parameter duration: 로딩 시간(나노초).
open func updateViewLoadingTime(_ duration: NSNumber)

/// 페이지 이탈
/// - Parameter property: 이벤트 사용자 정의 속성(선택 사항)
open func stopView(withProperty property: [AnyHashable : Any]?)

코드 예시

- (void)viewDidAppear:(BOOL)animated{
  [super viewDidAppear:animated];
  // 시나리오 1:
  [[FTExternalDataManager sharedManager] startViewWithName:@"TestVC"];

  // 시나리오 2: 동적 매개변수
  [[FTExternalDataManager sharedManager] startViewWithName:@"TestVC" property:@{@"custom_key":@"custom_value"}];
}
-(void)viewDidDisappear:(BOOL)animated{
  [super viewDidDisappear:animated];
  // 시나리오 1:
  [[FTExternalDataManager sharedManager] stopView];

  // 시나리오 2: 동적 매개변수
  [[FTExternalDataManager sharedManager] stopViewWithProperty:@{@"custom_key":@"custom_value"}];
}
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 시나리오 1:
    FTExternalDataManager.shared().startView(withName: "TestVC")
    // 시나리오 2: 동적 매개변수
    FTExternalDataManager.shared().startView(withName: "TestVC",property: ["custom_key":"custom_value"])
}
override func viewDidDisappear(_ animated: Bool) {
    super.viewDidDisappear(animated)
    // 시나리오 1:
    FTExternalDataManager.shared().stopView()
    // 시나리오 2: 동적 매개변수
    FTExternalDataManager.shared().stopView(withProperty: ["custom_key":"custom_value"])
}

SwiftUI View 수집

SwiftUI View는 자동 수집과 수동 수집을 지원합니다:

  • 자동 수집(실험적): SDK가 페이지를 자동으로 식별하고 FTRumConfig.swiftUIViewTrackingHandler를 통해 일괄적으로 필터링 및 이름 지정을 수행합니다. 사용 방법은 SwiftUI View 자동 수집(실험적)을 참조하세요.
  • 수동 수집: 특정 SwiftUI View에서 .ftTrackRUMView(name:property:)를 사용하여 페이지의 시작과 끝을 명시적으로 표시하고 View Name과 속성을 사용자 정의합니다. 안정적인 페이지 이름이 필요하거나 View 수명 주기를 정밀하게 제어해야 하거나 자동 추출된 이름이 예상과 다른 경우에 적합합니다.
import SwiftUI
import GuanceSDK
struct HomeView: View {
    var body: some View {
        VStack {
            Text("Home")
        }
        .ftTrackRUMView(
            name: "Home",
            property: ["page_type": "home"]
        )
    }
}

Action

사용 방법

/// RUM Action을 시작합니다.
///
/// RUM은 해당 Action이 트리거할 수 있는 Resource, Error, LongTask 이벤트를 바인딩합니다. 0.1초 내에 여러 번 추가하지 마세요. 동일한 View는 동시에 하나의 Action에만 연결되며, 이전 Action이 종료되지 않은 상태에서 새로 추가된 Action은 무시됩니다.
/// `addAction:actionType:property` 메서드로 추가한 Action과 서로 영향을 주지 않습니다.
///
/// - Parameters:
///   - actionName: 이벤트 이름
///   - actionType: 이벤트 유형
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)startAction:(NSString *)actionName actionType:(NSString *)actionType property:(nullable NSDictionary *)property;

/// Action 이벤트를 추가합니다. 무시 로직이 없으며 Resource, Error, LongTask 이벤트를 바인딩하지 않습니다
///
/// `startAction:actionType:property:`로 시작한 RUM Action과 서로 영향을 주지 않습니다.
/// - Parameters:
///   - actionName: 이벤트 이름
///   - actionType: 이벤트 유형
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)addAction:(NSString *)actionName actionType:(NSString *)actionType property:(nullable NSDictionary *)property;
/// RUM Action을 시작합니다.
///
/// RUM은 해당 Action이 트리거할 수 있는 Resource, Error, LongTask 이벤트를 바인딩합니다. 0.1초 내에 여러 번 추가하지 마세요. 동일한 View는 동시에 하나의 Action에만 연결되며, 이전 Action이 종료되지 않은 상태에서 새로 추가된 Action은 무시됩니다.
/// `addAction:actionType:property` 메서드로 추가한 Action과 서로 영향을 주지 않습니다.
///
/// - Parameters:
///   - actionName: 이벤트 이름
///   - actionType: 이벤트 유형
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func startAction(_ actionName: String, actionType: String, property: [AnyHashable : Any]?)

/// Action 이벤트를 추가합니다. 무시 로직이 없으며 Resource, Error, LongTask 이벤트를 바인딩하지 않습니다
///
/// `startAction:actionType:property:`로 시작한 RUM Action과 서로 영향을 주지 않습니다.
/// - Parameters:
///   - actionName: 이벤트 이름
///   - actionType: 이벤트 유형
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func addAction(_ actionName: String, actionType: String, property: [AnyHashable : Any]?)

코드 예시

// startAction
[[FTExternalDataManager sharedManager] startAction:@"action" actionType:@"click" property:@{@"action_property":@"testActionProperty1"}];
// addAction
[[FTExternalDataManager sharedManager] addAction:@"action" actionType:@"click" property:@{@"action_property":@"testActionProperty1"}];
// startAction
FTExternalDataManager.shared().startAction("custom_action", actionType: "click",property: nil)
// addAction
FTExternalDataManager.shared().addAction("custom_action", actionType: "click",property: nil)

SwiftUI Action 수동 수집

SwiftUI Action은 비즈니스 상호작용 지점에서 수동으로 추가해야 합니다. Button, NavigationLink, List 항목 또는 사용자 정의 제스처 등 SwiftUI 컴포넌트의 경우 사용자 조작이 발생한 위치에서 능동적으로 RUM Action을 기록하세요.

SwiftUI Action은 두 가지 수동 수집 방식을 지원합니다:

  • 기존 이벤트 클로저에서 호출: FTRUMSwiftUI.trackTapAction(name:property:)를 사용하며 추가 제스처를 추가하지 않으므로 Button, NavigationLink, List, 스크롤 뷰 또는 이미 사용자 정의 제스처가 있는 시나리오에 적합합니다.
  • View Modifier 사용: .ftTrackRUMTapAction(name:property:count:)를 사용하며 현재 View에 simultaneousGesture를 추가하므로 일반 View의 간단한 클릭 수집에 적합합니다.

주의: 동일한 클릭 이벤트가 이미 FTExternalDataManager를 통해 수동 수집된 경우 SwiftUI Action 수동 수집을 다시 사용하지 마세요. 중복 보고를 방지해야 합니다.

import SwiftUI
import GuanceSDK
struct ProductView: View {
    var body: some View {
        Button("Buy") {
            FTRUMSwiftUI.trackTapAction(
                name: "buy_click",
                property: ["source": "product_detail"]
            )

            // 비즈니스 클릭 로직 실행
            buy()
        }
    }

    private func buy() {
        // ...
    }
}
import SwiftUI
import GuanceSDK
struct ProductCard: View {
    var body: some View {
        Text("Buy")
            .ftTrackRUMTapAction(
                name: "buy_click",
                property: ["source": "product_card"]
            )
    }
}

FTRUMSwiftUI.trackTapAction(name:property:)는 더 권장되는 수동 수집 방식이며, 특히 기존 클릭 클로저가 있는 컴포넌트에 적합합니다. .ftTrackRUMTapAction(name:property:count:)는 편리한 표기법이지만 추가 클릭 제스처를 추가하므로 List, NavigationLink, 스크롤 컨테이너 또는 복잡한 제스처 조합에서 기존 상호작용에 영향을 줄 수 있습니다. 기존 클릭 클로저에서 FTRUMSwiftUI.trackTapAction(name:property:)를 호출하는 방식으로 변경하는 것이 좋습니다.

Error

사용 방법

/// Error 이벤트 추가
/// - Parameters:
///   - type: error 유형
///   - message: 오류 메시지
///   - stack: 스택 정보
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)addErrorWithType:(NSString *)type message:(NSString *)message stack:(NSString *)stack property:(nullable NSDictionary *)property;

/// Error 이벤트 추가
/// - Parameters:
///   - type: error 유형
///   - state: 프로그램 실행 상태
///   - message: 오류 메시지
///   - stack: 스택 정보
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)addErrorWithType:(NSString *)type state:(FTAppState)state  message:(NSString *)message stack:(NSString *)stack property:(nullable NSDictionary *)property;
/// Error 이벤트 추가
/// - Parameters:
///   - type: error 유형
///   - message: 오류 메시지
///   - stack: 스택 정보
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func addError(withType: String, message: String, stack: String, property: [AnyHashable : Any]?)

/// Error 이벤트 추가
/// - Parameters:
///   - type: error 유형
///   - state: 프로그램 실행 상태
///   - message: 오류 메시지
///   - stack: 스택 정보
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func addError(withType type: String, state: FTAppState, message: String, stack: String, property: [AnyHashable : Any]?)

코드 예시

// 시나리오 1
[[FTExternalDataManager sharedManager] addErrorWithType:@"type" message:@"message" stack:@"stack"];
// 시나리오 2: 동적 매개변수
[[FTExternalDataManager sharedManager] addErrorWithType:@"ios_crash" message:@"crash_message" stack:@"crash_stack" property:@{@"custom_key":@"custom_value"}];
// 시나리오 3: 동적 매개변수
[[FTExternalDataManager sharedManager] addErrorWithType:@"ios_crash" state:FTAppStateUnknown message:@"crash_message" stack:@"crash_stack" property:@{@"custom_key":@"custom_value"}];
// 시나리오 1
FTExternalDataManager.shared().addError(withType: "custom_type", message: "custom_message", stack: "custom_stack")
// 시나리오 2: 동적 매개변수
FTExternalDataManager.shared().addError(withType: "custom_type", message: "custom_message", stack: "custom_stack",property: ["custom_key":"custom_value"])
// 시나리오 3: 동적 매개변수
FTExternalDataManager.shared().addError(withType: "custom_type", state: .unknown, message: "custom_message", stack: "custom_stack", property: ["custom_key":"custom_value"])

LongTask

사용 방법

/// 버벅임 이벤트 추가
/// - Parameters:
///   - stack: 버벅임 스택
///   - duration: 버벅임 지속 시간(나노초)
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)addLongTaskWithStack:(NSString *)stack duration:(NSNumber *)duration property:(nullable NSDictionary *)property;
/// 버벅임 이벤트 추가
/// - Parameters:
///   - stack: 버벅임 스택
///   - duration: 버벅임 지속 시간(나노초)
///   - property: 이벤트 사용자 정의 속성(선택 사항)
func addLongTask(withStack: String, duration: NSNumber, property: [AnyHashable : Any]?)

코드 예시

// 시나리오 1
[[FTExternalDataManager sharedManager] addLongTaskWithStack:@"stack string" duration:@1000000000];
// 시나리오 2: 동적 매개변수
[[FTExternalDataManager sharedManager] addLongTaskWithStack:@"stack string" duration:@1000000000 property:@{@"custom_key":@"custom_value"}];
// 시나리오 1
FTExternalDataManager.shared().addLongTask(withStack: "stack string", duration: 1000000000)
// 시나리오 2: 동적 매개변수
FTExternalDataManager.shared().addLongTask(withStack: "stack string", duration: 1000000000 ,property: [["custom_key":"custom_value"]])

Resource

사용 방법

/// HTTP 요청 시작
/// - Parameters:
///   - key: 요청 식별자
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)startResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;

/// HTTP 요청 데이터 추가
///
/// - Parameters:
///   - key: 요청 식별자
///   - metrics: 요청 관련 성능 속성
///   - content: 요청 관련 데이터
- (void)addResourceWithKey:(NSString *)key metrics:(nullable FTResourceMetricsModel *)metrics content:(FTResourceContentModel *)content;

/// HTTP 요청 종료
/// - Parameters:
///   - key: 요청 식별자
///   - property: 이벤트 사용자 정의 속성(선택 사항)
- (void)stopResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;
/// HTTP 요청 시작
/// - Parameters:
///   - key: 요청 식별자
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func startResource(withKey key: String, property: [AnyHashable : Any]?)

/// HTTP 요청 종료
/// - Parameters:
///   - key: 요청 식별자
///   - property: 이벤트 사용자 정의 속성(선택 사항)
open func stopResource(withKey key: String, property: [AnyHashable : Any]?)

/// HTTP 요청 데이터 추가
///
/// - Parameters:
///   - key: 요청 식별자
///   - metrics: 요청 관련 성능 속성
///   - content: 요청 관련 데이터
open func addResource(withKey key: String, metrics: FTResourceMetricsModel?, content: FTResourceContentModel)

코드 예시

// 1단계: 요청 시작 전
[[FTExternalDataManager sharedManager] startResourceWithKey:key];

// 2단계: 요청 완료
[[FTExternalDataManager sharedManager] stopResourceWithKey:key];

// 3단계: Resource 데이터 구성
// FTResourceContentModel 데이터
FTResourceContentModel *content = [[FTResourceContentModel alloc]init];
content.httpMethod = request.HTTPMethod;
content.requestHeader = request.allHTTPHeaderFields;
content.responseHeader = httpResponse.allHeaderFields;
content.httpStatusCode = httpResponse.statusCode;
content.responseBody = responseBody;
// iOS 네이티브
content.error = error;

// 각 단계의 시간 데이터를 얻을 수 있는 경우
// FTResourceMetricsModel
// iOS 네이티브에서 NSURLSessionTaskMetrics 데이터를 얻은 경우 FTResourceMetricsModel의 초기화 메서드를 직접 사용합니다
FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]initWithTaskMetrics:metrics];

// 기타 플랫폼: 모든 시간 데이터는 나노초 단위입니다
FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]init];

// 4단계: add resource, 시간 데이터가 없으면 metrics에 nil을 전달합니다
[[FTExternalDataManager sharedManager] addResourceWithKey:key metrics:metricsModel content:content];
// 1단계: 요청 시작 전
FTExternalDataManager.shared().startResource(withKey: key)

// 2단계: 요청 완료
FTExternalDataManager.shared().stopResource(withKey: resource.key)

// 3단계: ① Resource 데이터 구성
let contentModel = FTResourceContentModel(request: task.currentRequest!, response: task.response as? HTTPURLResponse, data: resource.data, error: error)

// ② 각 단계의 시간 데이터를 얻을 수 있는 경우
// FTResourceMetricsModel
// iOS 네이티브에서 NSURLSessionTaskMetrics 데이터를 얻은 경우 FTResourceMetricsModel의 초기화 메서드를 직접 사용합니다
var metricsModel:FTResourceMetricsModel?
if let metrics = resource.metrics {
   metricsModel = FTResourceMetricsModel(taskMetrics:metrics)
}
// 기타 플랫폼: 모든 시간 데이터는 나노초 단위입니다
metricsModel = FTResourceMetricsModel()
...

// 4단계: add resource, 시간 데이터가 없으면 metrics에 nil을 전달합니다
FTExternalDataManager.shared().addResource(withKey: resource.key, metrics: metricsModel, content: contentModel)

NSURLConnection Resource 자동 수집

SDK 1.6.8+ 지원

기존 NSURLConnection 요청이 있는 프로젝트에서는 Resource 자동 수집을 독립적으로 활성화할 수 있습니다. 이 스위치는 URLSession의 enableTraceUserResource를 대체하거나 자동으로 활성화하지 않습니다.

FTRumConfig *rumConfig = [[FTRumConfig alloc] initWithAppid:appid];
rumConfig.enableTraceURLConnectionResource = YES;
// URLSession을 함께 사용하는 경우 필요에 따라 enableTraceUserResource를 별도로 설정합니다.
[[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
let rumConfig = FTRumConfig(appid: appid)
rumConfig.enableTraceURLConnectionResource = true
FTSDKAgent.sharedInstance().startRum(withConfigOptions: rumConfig)

기본적으로 비활성화됩니다. 요청 필터링, 사용자 정의 Resource 속성 및 오류 필터링은 계속 resourceUrlHandler, resourcePropertyProvider, sessionTaskErrorFilter를 사용합니다. Trace 요청 헤더가 필요한 경우 NSURLConnection Trace를 별도로 활성화하세요. 각 성능 필드는 수집 측에서 실제로 사용 가능한 데이터를 기준으로 하며, URLSessionTaskMetrics의 모든 세부 정보를 갖추는 것은 보장되지 않습니다.

문서 평가

이 페이지가 도움이 되었나요?