콘텐츠로 이동

Trace 설정

Trace 초기화 설정

   //Trace 활성화
   FTTraceConfig *traceConfig = [[FTTraceConfig alloc]init];
   traceConfig.enableLinkRumData = YES;
   traceConfig.enableAutoTrace = YES;
   traceConfig.networkTraceType = FTNetworkTraceTypeDDtrace;
   [[FTMobileAgent sharedInstance] startTraceWithConfigOptions:traceConfig];
   let traceConfig = FTTraceConfig.init()
   traceConfig.enableLinkRumData = true
   traceConfig.enableAutoTrace = true
   FTMobileAgent.sharedInstance().startTrace(withConfigOptions: traceConfig)
속성 유형 필수 의미
traceSamplingRate float 아니요 Trace 샘플링 비율이며 범위는 [0,100]이고 소수점을 지원합니다. 기본값은 100입니다. 0.1은 0.1%를, 1은 1%를 의미합니다. SDK 1.6.8부터 지원됩니다.
sampleRate int 아니요 SDK 1.6.8부터 사용 중단되었으며 호환성을 위해 유지됩니다. 정수 백분율 샘플링 비율이며 범위는 [0,100]이고 기본값은 100입니다. traceSamplingRate 사용을 권장합니다.
networkTraceType FTNetworkTraceType 아니요 분산 추적 유형을 설정합니다. 기본값은 DDTrace이며, 현재 Zipkin, Jaeger, DDTrace, Skywalking(8.0+), TraceParent(W3C)를 지원합니다. OpenTelemetry를 연동하여 해당 분산 추적 유형을 선택할 경우 지원 유형 및 agent 관련 설정을 확인하시기 바랍니다.
enableLinkRumData BOOL 아니요 RUM 데이터와 연관지을지 여부입니다. 기본값은 NO입니다.
enableAutoTrace BOOL 아니요 자동 HTTP trace 활성화 여부를 설정합니다. 기본값은 NO이며, 현재 NSURLSession만 지원합니다.
enableAutoTraceURLConnection BOOL 아니요 SDK 1.6.8+: NSURLConnection에 Trace 요청 헤더를 자동으로 주입하며 기본값은 NO입니다. URLSession을 제어하는 enableAutoTrace와는 독립적입니다. NSURLConnection Trace를 참조하세요.
traceInterceptor FTTraceInterceptor 아니요 URLRequest를 통해 사용자 정의 분산 추적 수행 여부를 판단할 수 있습니다. 인터셉트가 확인되면 TraceContext를 반환하고, 인터셉트하지 않으면 nil을 반환합니다. 이 매개변수는 SDK 1.5.10 이상에서 지원됩니다. 우선순위는 URLSession 사용자 정의 수집보다 낮습니다.
샘플링 비율 매개변수 이름

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

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

Trace 네트워크 분산 추적

FTTraceConfig 설정을 통해 자동 모드를 활성화할 수 있으며, 사용자가 Trace 관련 데이터를 직접 추가할 수도 있습니다. 사용자 정의 추가 관련 API는 다음과 같습니다.

NSString *key = [[NSUUID UUID]UUIDString];
NSURL *url = [NSURL URLWithString:@"http://www.baidu.com"];
//필요한 수동 작업: 요청 전에 traceHeader를 가져와 요청 헤더에 추가
NSDictionary *traceHeader = [[FTTraceManager sharedInstance] getTraceHeaderWithKey:key url:url];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
if (traceHeader && traceHeader.allKeys.count>0) {
    [traceHeader enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
        [request setValue:value forHTTPHeaderField:field];
    }];
}
NSURLSession *session=[NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];

NSURLSessionTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
   //사용자 코드
}];

[task resume];
let url:URL = NSURL.init(string: "https://www.baidu.com")! as URL
if let traceHeader = FTExternalDataManager.shared().getTraceHeader(withKey: NSUUID().uuidString, url: url) {
     let request = NSMutableURLRequest(url: url)
     //필요한 수동 작업: 요청 전에 traceHeader를 가져와 요청 헤더에 추가
     for (a,b) in traceHeader {
         request.setValue(b as? String, forHTTPHeaderField: a as! String)
     }
     let task = URLSession.shared.dataTask(with: request as URLRequest) {  data,  response,  error in
        //사용자 코드
     }
     task.resume()
}

URLSession 고급 수집

특정 URLSession 인스턴스에 대해 더 세밀한 Resource 수집, Trace 주입 및 오류 필터링을 수행하려면 URLSession 사용자 정의 Network 수집을 참조하세요.

NSURLConnection Trace

SDK 1.6.8+ 지원

enableAutoTraceURLConnection은 NSURLConnection의 자동 Trace 요청 헤더 주입을 제어하며 기본값은 NO입니다. 이 설정은 URLSession을 제어하는 enableAutoTrace와도 독립적이고, RUM의 enableTraceURLConnectionResource와도 독립적입니다.

FTTraceConfig *traceConfig = [[FTTraceConfig alloc] init];
traceConfig.enableAutoTraceURLConnection = YES;
traceConfig.traceSamplingRate = 100;
[[FTSDKAgent sharedInstance] startTraceWithConfigOptions:traceConfig];
let traceConfig = FTTraceConfig()
traceConfig.enableAutoTraceURLConnection = true
traceConfig.traceSamplingRate = 100
FTSDKAgent.sharedInstance().startTrace(withConfigOptions: traceConfig)

기존 networkTraceType, traceInterceptor 및 샘플링 설정은 계속 적용됩니다. RUM Resource와 해당 Trace 연관을 함께 생성하려면 NSURLConnection Resource 수집을 별도로 활성화하고, 기존 Trace 연관 규칙에 따라 enableLinkRumData와 Trace 유형을 설정해야 합니다.

문서 평가

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