수동 연동¶
ft-plugin을 사용하지 않고 SDK 연동하기¶
Guance는 Android Gradle Plugin Transformation을 통한 코드 주입으로 데이터를 자동 수집합니다. 그러나 일부 호환성 문제로 ft-plugin 또는 ft-plugin-legacy를 사용할 수 없는 경우가 있습니다. 영향 범위는 다음과 같습니다.
- RUM의
Action,Resource android.util.Log- Java 및 Kotlin
println콘솔 로그 자동 수집 - 심볼 파일 자동 업로드
현재 이러한 경우에는 수동 연동 방식을 사용할 수 있습니다.
Application 시작 이벤트¶
소스 코드 예시는 DemoForManualSet.kt를 참조하세요.
사용자 작업 수동 추가¶
버튼 등의 이벤트는 트리거 지점에서 직접 추가해야 합니다. 여기서는 Button onClick 이벤트를 예로 듭니다. 소스 코드 예시는 ManualActivity.kt를 참조하세요:
OkHttp Resource / Trace 수동 연동¶
OkHttp는 addInterceptor, eventListener 방식으로 Resource와 Trace를 연동할 수 있습니다. 예시는 다음과 같습니다. 소스 코드 예시는 ManualActivity.kt를 참조하세요:
OkHttpClient.Builder builder = new OkHttpClient.Builder()
.addInterceptor(new FTTraceInterceptor())
.addInterceptor(new FTResourceInterceptor())
.eventListenerFactory(new FTResourceEventListener.FTFactory());
//.eventListenerFactory(new FTResourceEventListener.FTFactory(true));
OkHttpClient client = builder.build();
다른 네트워크 프레임워크는 FTRUMGlobalManager.startResource, stopResource, addResource 및 FTTraceManager.getTraceHeader를 직접 구현해야 합니다. 구체적인 구현 방법은 소스 코드 예시 ManualActivity.kt를 참조하세요.
OkHttp Visitor ID 수동 연동¶
ft-sdk >= 1.7.6-alpha04인 경우 먼저 방문자 식별자 Visitor ID에 따라 초기화를 완료한 다음, FTVisitorIdInterceptor.install(builder)를 통해 비즈니스 OkHttpClient에 인터셉터를 설치합니다. Visitor ID Header만 주입할 때는 Resource 또는 Trace 인터셉터를 설치할 필요가 없습니다:
Resource / Trace도 함께 수집해야 한다면, 이전 섹션 예시에서 다른 인터셉터를 추가한 후 builder.build() 전에 install(builder)를 호출하면 됩니다. 이 메서드는 Visitor ID 적용 인터셉터를 FTResourceInterceptor 앞에 배치하고, 리디렉션 보호 인터셉터를 현재 네트워크 인터셉터 목록 끝에 추가합니다. 다른 인터셉터 구성을 완료한 후 호출하세요.
install(builder)를 사용하세요. addInterceptor(new FTVisitorIdInterceptor())만으로 연동하지 마세요. 그렇게 하면 리디렉션 보호가 누락됩니다. 동일한 Builder에서 install을 여러 번 호출해도 Visitor ID 인터셉터가 중복 설치되지 않으며, Resource 또는 Trace 수집이 자동으로 활성화되지도 않습니다.
OkHttp WebSocket Resource 수동 연동¶
ft-sdk >= 1.7.5인 경우, WebSocket 자동 계측을 지원하는 ft-plugin을 사용하지 않는다면 FTWebSocket을 통해 OkHttp WebSocket 핸드셰이크 Resource를 명시적으로 수집할 수 있습니다. 먼저 FTRUMConfig.setEnableTraceUserResource(true)를 활성화해야 합니다. 기존 Resource URL 필터링 및 RUM 샘플링 규칙은 계속 적용됩니다. 수집 범위는 핸드셰이크 성공, 서버 측 거부 또는 실패뿐이며, 연결 유지 시간은 집계하지 않고 메시지 내용도 수집하지 않습니다.
호출 지점이 적다면 FTWebSocket.newWebSocket()을 직접 사용할 수 있습니다:
프로젝트에서 의존성 주입으로 WebSocket factory를 통일되게 제공한다면, 한 번 래핑한 후 WebSocket.Factory로 주입할 수 있습니다:
wrap()은 여러 번 호출할 수 있습니다. ft-plugin >= 1.3.8이 동시에 활성화된 경우에도 동일한 요청의 핸드셰이크 Resource는 한 번만 수집됩니다. 서드파티 라이브러리가 내부에서 OkHttpClient를 보유하고 있고 newWebSocket() 호출 지점을 열어두지 않으며 WebSocket.Factory 전달도 허용하지 않는 경우에는 여전히 ft-plugin 자동 계측을 사용해야 합니다.