Trace 설정¶
Trace 초기화 설정¶
| 속성 | 유형 | 필수 | 의미 |
|---|---|---|---|
| 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와도 독립적입니다.
기존 networkTraceType, traceInterceptor 및 샘플링 설정은 계속 적용됩니다. RUM Resource와 해당 Trace 연관을 함께 생성하려면 NSURLConnection Resource 수집을 별도로 활성화하고, 기존 Trace 연관 규칙에 따라 enableLinkRumData와 Trace 유형을 설정해야 합니다.