콘텐츠로 이동

Trace 구성

await FTTracer().setConfig(
  enableLinkRUMData: true,
  enableAutoTrace: true,
);
필드 유형 필수 설명
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을 참고하세요.

문서 평가

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