Trace 구성¶
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| traceSamplingRate | double | 아니요 | Trace 샘플링 레이트로, 범위는 [0,100]이며 소수를 지원하고 기본값은 100입니다. 0.1은 0.1%, 1은 1%를 의미합니다. SDK 0.5.8부터 지원됩니다. |
| sampleRate | double | 아니요 | 기존 확률 설정으로, 호환성을 위해 유지됩니다. Trace 샘플링 레이트로, 범위는 [0,1]이며 기본값은 1입니다. 0.1은 10%, 1은 100%를 의미합니다. traceSamplingRate로 변경하여 사용하는 것을 권장합니다. |
| traceType | enum TraceType | 아니요 | 트레이스 유형으로, 기본값은 TraceType.ddTrace이며 ddTrace, zipkinMulti, zipkinSingle, traceparent, skywalking, jaeger를 지원합니다 |
| enableLinkRUMData | bool | 아니요 | RUM 데이터와 연결할지 여부이며, 기본값은 false입니다 |
| enableAutoTrace | bool | 아니요 | http 요청에 Trace Header를 자동으로 추가할지 여부이며, 기본값은 false입니다. HttpOverrides.global을 수정하여 구현하며, 프로젝트에 커스터마이징 요구 사항이 있으면 FTHttpOverrides를 상속해야 합니다 |
| enableNativeAutoTrace | bool | 아니요 | 네이티브 네트워크 자동 추적을 활성화할지 여부이며(iOS NSURLSession, Android OKHttp), 기본값은 false입니다 |
백분율 샘플링 마이그레이션¶
SDK 0.5.8부터 지원됩니다.
샘플링 레이트 파라미터 명명
SDK 0.5.8부터는 traceSamplingRate 사용을 권장하며, 값은 0~100의 백분율이고 소수를 지원합니다. 0은 샘플링하지 않음, 100은 전체 샘플링을 의미합니다. 범위를 벗어난 값, NaN 또는 무한대 등 유효하지 않은 값은 ArgumentError를 발생시킵니다.
기존 sampleRate는 하위 호환성을 위해 계속 유지되며, 값은 0~1의 확률입니다. 예를 들어 기존 필드의 0.1은 10%를, 새 필드의 0.1은 0.1%를 의미합니다. 새 필드와 기존 필드를 동시에 설정하면 명시적인 0을 포함하여 새 백분율 필드가 우선합니다.
원격 샘플링 필드의 단위와 우선순위는 Flutter 원격 구성 필드를 참고하세요.
예를 들어 12.5%의 Trace 샘플링으로 마이그레이션하면 다음과 같습니다.
await FTTracer().setConfig(
enableAutoTrace: true,
- sampleRate: 0.125,
+ traceSamplingRate: 12.5,
);
Tracer 네트워크 트레이스¶
자동 수집¶
FTTracer().setConfig에서 enableAutoTrace를 활성화하여 구현합니다.
사용자 정의 Tracer¶
사용 방법¶
/// trace http 요청 헤더 데이터 가져오기
/// [key] 고유 id
/// [url] 요청 주소
Future<Map<String, String>> getTraceHeader(String url, {String? key})
코드 예시¶
void httpClientGetHttp() async {
var url = 'http://reqeust.url.cn';
var httpClient = HttpClient();
String key = DateTime.now().millisecondsSinceEpoch.toString() + url;
var errorMessage = "";
HttpClientRequest request = await httpClient.getUrl(Uri.parse(url));
HttpClientResponse? response;
try {
final traceHeaders =
await FTTracer().getTraceHeader(request.uri.toString(), key: key);
traceHeaders.forEach((key, value) {
request.headers.add(key, value);
});
response = await request.close();
} catch (exception) {
errorMessage = exception.toString();
} finally {
Map<String, dynamic> requestHeader = {};
Map<String, dynamic> responseHeader = {};
request.headers.forEach((name, values) {
requestHeader[name] = values;
});
if (response != null) {
response.headers.forEach((name, values) {
responseHeader[name] = values;
});
}
}
}
http라이브러리와dio라이브러리 사용 예시는 example을 참고하세요.