콘텐츠로 이동

Trace 구성¶

Trace 초기화 구성¶

var tracer = uni.requireNativePlugin("GCUniPlugin-Tracer");
tracer.setConfig({
    traceType: 'ddTrace'
});

매개변수명	매개변수 타입	필수	매개변수 설명
samplerate	number	아니요	샘플링 비율, 범위 `[0,1]`, 기본값 `1`
traceType	string	아니요	추적 유형: `ddTrace`(기본값), `zipkinMultiHeader`, `zipkinSingleHeader`, `traceparent`, `skywalking`, `jaeger`
enableLinkRUMData	boolean	아니요	`RUM` 데이터와 연결 여부, 기본값 `false`
enableNativeAutoTrace	boolean	아니요	네이티브 네트워크 자동 추적 활성화 여부. iOS는 `NSURLSession`, Android는 `OKhttp` 지원, 기본값 `false`. Android 클라우드 패키징은 미지원. uni-app이 iOS에서 시스템 API를 통해 네트워크 요청을 보내므로 활성화 시 해당 요청이 자동으로 추적됨. 이 경우 iOS 측에서 수동 Trace 수집을 차단하여 추적과 `RUM` 데이터의 연결 오류를 방지해야 함

Tracer 네트워크 추적¶

자동 수집¶

SDK 0.2.7 이상에서 gcResourceTracking을 활성화하면 표준 uni.request가 Trace 구성에 맞는 전파 헤더(Propagation Header)를 자동으로 추가하므로 요청 메서드를 변경할 필요가 없습니다. RUM 구성의 Resource 자동 수집을 참고하세요.

수동 수집¶

var tracer = uni.requireNativePlugin("GCUniPlugin-Tracer");
let key = Utils.getUUID();
var header = tracer.getTraceHeader({
    key: key,
    url: requestUrl
});

uni.request({
    url: requestUrl,
    header: header,
    success() {
    },
    complete() {
    }
});

API - getTraceHeader¶

Trace 요청 헤더를 가져와 HTTP 요청 헤더에 추가합니다.

필드	타입	필수	설명
key	string	예	요청 고유 식별자
url	string	예	요청 URL

반환 값 타입: object