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);
}