콘텐츠로 이동

Trace 설정

Trace 초기화 설정

let traceConfig: FTTraceConfig = {
  traceSamplingRate: 100,
  enableNativeAutoTrace: true,
};
await FTReactNativeTrace.setConfig(traceConfig);
필드 유형 필수 설명
traceSamplingRate number 아니요 샘플링 백분율로 범위는 [0,100]이고 소수점을 지원하며 기본값은 100입니다. sampleRate보다 우선 적용되며, 명시적으로 0으로 설정한 경우에도 마찬가지입니다. SDK 0.4.3부터 지원됩니다.
sampleRate number 아니요 SDK 0.4.3부터 폐기되었으며 호환성을 위해 유지됩니다. 범위는 [0,1]이고 기본값은 1이며, traceSamplingRate가 설정되지 않은 경우에만 적용됩니다. traceSamplingRate 사용을 권장합니다.
traceType enum TraceType 아니요 트레이스 유형으로 기본값은 TraceType.ddTrace입니다. TraceType.ddTrace, TraceType.zipkinMulti, TraceType.zipkinSingle, TraceType.traceparent, TraceType.skywalking, TraceType.jaeger를 지원합니다.
enableLinkRUMData boolean 아니요 RUM 데이터와 연관지을지 여부이며 기본값은 false입니다.
enableNativeAutoTrace boolean 아니요 iOS의 NSURLSession, Android의 OKhttp에 대한 네이티브 네트워크 자동 추적을 활성화할지 여부입니다. React Native의 네트워크 요청은 iOS와 Android에서 시스템 API로 구현되므로, 활성화하면 React Native HTTP(S) 요청도 함께 추적할 수 있습니다. iOS WebSocket은 FTRUMConfig.enableIOSWebSocketResource도 활성화해야 하며, 자세한 내용은 WebSocket 핸드셰이크 수집을 참고하십시오.

SDK 0.4.3부터 소수점 백분율 샘플링을 지원합니다. traceSamplingRate: 12.5는 12.5%를, 1은 1%를, 100은 전체 수집을 의미합니다. 마이그레이션 규칙은 샘플링 설정을 참고하십시오.

Tracer 네트워크 분산 추적

SDK에서 Trace 설정을 초기화할 때 자동 네트워크 분산 추적을 활성화할 수 있으며, 사용자 정의 수집도 지원합니다.

사용 방법

/**
 * trace HTTP 요청 헤더 데이터를 가져옵니다.
 * @deprecated getTraceHeaderFields()를 대신 사용하십시오.
 */
getTraceHeader(key: String, url: String): Promise<object>;

/**
 * trace HTTP 요청 헤더 데이터를 가져옵니다.
 */
getTraceHeaderFields(url: String, key?: String): Promise<object>;

사용 예시

import { FTReactNativeTrace } from '@cloudcare/react-native-mobile';
async function getHttp(url: string) {
  const key = Utils.getUUID();
  const traceHeader = await FTReactNativeTrace.getTraceHeaderFields(url);
  const fetchOptions = {
    method: 'GET',
    headers: Object.assign(
      {
        Accept: 'application/json',
        'Content-Type': 'application/json',
      },
      traceHeader,
    ),
  };
  fetch(url, fetchOptions);
}

문서 평가

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