콘텐츠로 이동

RUM 설정

샘플링 필드 마이그레이션(ft-sdk >= 1.7.6): setSessionSamplingRate는 0~100 범위의 부동소수점 백분율을 사용합니다. 기존 setSamplingRate는 0~1 단위를 유지하며, 마이그레이션 시 값에 100을 곱합니다. 새 필드는 명시적으로 설정한 경우에만 기존 필드보다 우선하며, 잘못된 값은 예외를 발생시키고 기존 유효 값을 변경하지 않습니다. 이보다 낮은 버전에서는 기존 메서드를 계속 사용합니다. 지원 중단은 제거를 의미하지 않으며, 기존 메서드는 원래 단위와 동작을 유지합니다.

RUM 초기화 설정

FTSdk.initRUMWithConfig(
        new FTRUMConfig()
            .setRumAppId(RUM_APP_ID)
            .setEnableTraceUserView(true)
            .setDeviceMetricsMonitorType(DeviceMetricsMonitorType.ALL.getValue())
            .setEnableTraceUserAction(true)
            .setEnableTraceUserResource(true)
            .setEnableTrackAppUIBlock(true)
            .setEnableTrackAppCrash(true)
            .setEnableTrackAppANR(true)
            .setExtraMonitorTypeWithError(ErrorMonitorType.ALL.getValue())
);
FTSdk.initRUMWithConfig(
    FTRUMConfig()
        .setRumAppId(RUM_APP_ID)
        .setEnableTraceUserView(true)
        .setDeviceMetricsMonitorType(DeviceMetricsMonitorType.ALL.getValue())
        .setEnableTraceUserAction(true)
        .setEnableTraceUserResource(true)
        .setEnableTrackAppUIBlock(true)
        .setEnableTrackAppCrash(true)
        .setEnableTrackAppANR(true)
        .setExtraMonitorTypeWithError(ErrorMonitorType.ALL.getValue())
)
메서드명 유형 필수 의미
setRumAppId String 예 RUM AppId를 설정합니다. RUM appid를 설정해야 RUM 수집 기능이 활성화됩니다. appid 확인 방법
setSessionSamplingRate Float 아니요 샘플링 백분율, 범위 [0,100], 기본값 100. 소수 값을 지원하며, 예를 들어 0.1은 0.1%를 의미합니다. 0은 수집 안 함, 100은 전체 수집을 의미합니다. 새 필드를 명시적으로 설정하면 설정 순서와 관계없이 기존 필드보다 우선합니다. ft-sdk >= 1.7.6에서 지원합니다.
setSamplingRate Float 아니요 ft-sdk 1.7.6부터 지원 중단, 호환성 유지. 수집률을 설정합니다. 값 범위는 [0,1]이며, 0은 수집 안 함, 1은 전체 수집, 기본값은 1입니다. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다.
setSessionOnErrorSamplingRate float 아니요 오류 세션 샘플링 백분율, 범위 [0,100], 기본값 0, 소수 값을 지원합니다. 일반 세션이 샘플링되지 않았고 오류가 발생한 경우 이 비율에 따라 오류 발생 전 1분 범위의 데이터를 추가 수집합니다. 새 필드를 명시적으로 설정하면 기존 필드보다 우선합니다. ft-sdk >= 1.7.6에서 지원합니다.
setSessionErrorSampleRate Float 아니요 ft-sdk 1.7.6부터 지원 중단, 0~1 호환성 유지. 오류 수집률을 설정합니다. 세션이 setSamplingRate로 샘플링되지 않은 경우, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집 안 함, 1은 전체 수집, 기본값은 0입니다. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터이며, ft-sdk 1.6.11 이상에서 지원합니다.
setEnableTrackAppCrash Boolean 아니요 App 크래시 로그 업로드 여부. 기본값은 false이며, 활성화하면 오류 분석에 오류 스택 데이터가 표시됩니다. 크래시 로그의 난독화 내용 변환에 대해서는 심볼 파일 업로드를 참조하세요. ft-sdk 1.5.1 이상 버전에서는 extraLogCatWithJavaCrash, extraLogCatWithNativeCrash를 통해 Java Crash 및 Native Crash에서 logcat 표시 여부를 설정할 수 있습니다.
setIssueDataProvider FTIssueDataProvider 아니요 자동 수집된 Java/Native Crash 및 watchdog/native ANR Error에 검증된 사용자 정의 필드를 추가합니다. 과거 복구 데이터를 포함하며, 기본적으로 설정되지 않습니다. ft-sdk 1.7.5 이상에서 지원합니다. 자세한 내용은 Crash/ANR 사용자 정의 필드를 참조하세요.
setExtraMonitorTypeWithError Array 아니요 보조 모니터링 정보를 설정하고 추가 모니터링 데이터를 RUM 크래시 데이터에 추가합니다. ErrorMonitorType.BATTERY는 배터리 잔량, ErrorMonitorType.MEMORY는 메모리 사용량, ErrorMonitorType.CPU는 CPU 점유율이며, 기본적으로 설정되지 않습니다.
setDeviceMetricsMonitorType Array 아니요 View 모니터링 정보를 설정하고 View 주기 동안 모니터링 데이터를 추가합니다. DeviceMetricsMonitorType.BATTERY는 현재 페이지의 최대 전류 출력 상태를 모니터링하고, DeviceMetricsMonitorType.MEMORY는 현재 앱의 메모리 사용량을 모니터링하며, DeviceMetricsMonitorType.CPU는 CPU 점프 횟수를 모니터링하고, DeviceMetricsMonitorType.FPS는 화면 프레임 속도를 모니터링합니다. 모니터링 주기는 DetectFrequency.DEFAULT 500밀리초, DetectFrequency.FREQUENT 100밀리초, DetectFrequency.RARE 1초 중 선택할 수 있으며, 기본적으로 설정되지 않습니다.
setEnableTrackAppANR Boolean 아니요 ANR 수집 활성화 여부. 기본값은 false입니다. ft-sdk 1.7.5부터 Android 11(API 30) 이상에서는 프로세스가 이후에 시작될 때 ApplicationExitInfo를 통해 치명적인 ANR을 복구하며, 비치명적 실시간 ANR은 수집하지 않습니다. Android 10(API 29) 이하에서는 실시간 watchdog/native ANR 수집을 계속 사용합니다. extraLogCatWithANR은 API 29 이하의 실시간 수집 경로에만 사용됩니다.
setEnableTrackAppUIBlock Boolean, long 아니요 UI 멈춤 감지 활성화 여부. 기본값은 false이며, ft-sdk 1.6.4 이상 버전에서는 blockDurationMs로 감지 시간 범위 [100,)을 제어할 수 있습니다. 단위는 밀리초이며 기본값은 1초입니다.
setEnableTraceUserAction Boolean 아니요 사용자 작업 자동 추적 여부. 현재는 사용자 시작 및 클릭 작업만 지원합니다. 이 설정은 ft-plugin에 의존하며 기본값은 false입니다.
setEnableTraceUserView Boolean 아니요 사용자 페이지 작업 자동 추적 여부. 이 설정은 ft-plugin에 의존하며 기본값은 false입니다.
setEnableTraceUserViewInFragment Boolean 아니요 Fragment 유형 페이지 데이터 자동 추적 여부. 이 설정은 ft-plugin에 의존하며 기본값은 false입니다. ft-sdk 1.6.11 이상에서 지원합니다.
setInitialResourceIdentifier FTInitialResourceIdentifier 아니요 네이티브 View network_settled_time 계산에 참여하는 Resource 판단 규칙을 설정합니다. 기본적으로 100ms 시간 창을 사용합니다. null은 허용되지 않으며, 규칙이 false를 반환하면 해당 지표 기여만 제외되고 Resource 이벤트는 삭제되지 않습니다. 자세한 내용은 View 소요 시간 지표 사용자 정의 규칙을 참조하세요.
setLastInteractionIdentifier FTLastInteractionIdentifier 아니요 네이티브 View interaction_to_next_view_time의 이전 페이지 상호작용 판단 규칙을 설정합니다. 기본적으로 시간 차이가 0보다 크고 3000ms보다 작아야 합니다. null을 전달하면 자동 INV가 비활성화됩니다. 자세한 내용은 View 소요 시간 지표 사용자 정의 규칙을 참조하세요.
setEnableTraceUserResource Boolean 아니요 네트워크 요청 Resource 수집 여부. 기본값은 false입니다. OkHttp, HttpURLConnection / HttpsURLConnection 및 OkHttp WebSocket 핸드셰이크를 지원하며, 각 방식의 연동 요구 사항은 Resource 자동 수집을 참조하세요.
setEnableHttpURLConnectionResource Boolean 아니요 HttpURLConnection / HttpsURLConnection Resource 자동 수집 여부. 기본값은 false입니다. setEnableTraceUserResource(true)를 함께 활성화해야 하며, ft-sdk >= 1.7.6-alpha03 및 ft-plugin >= 1.3.9-alpha01이 필요합니다. 자세한 내용은 URLConnection 자동 수집을 참조하세요.
setEnableResourceHostIP Boolean 아니요 요청 대상 도메인 주소의 IP 수집 여부. 적용 범위: enableTraceUserResource가 true인 OkHttp 기본 수집에만 영향을 미치며 URLConnection에는 적용되지 않습니다. 사용자 정의 Resource 수집에서 이 기능을 활성화하려면 FTResourceEventListener.FTFactory(true)를 사용해야 합니다. 또한 단일 OkHttp는 동일한 도메인에 대해 IP 캐시 메커니즘이 있어, 동일한 OkHttpClient는 서버 IP가 변경되지 않는 한 IP가 한 번만 생성됩니다.
setResourceUrlHandler Callback 아니요 필터링할 Resource 조건을 설정합니다. 기본적으로 필터링하지 않습니다.
setOkHttpEventListenerHandler Callback 아니요 ASM으로 전역 OkHttp EventListener를 설정합니다. 기본적으로 설정되지 않습니다.
setOkHttpResourceContentHandler Callback 아니요 ASM으로 전역 FTResourceInterceptor.ContentHandlerHelper를 설정합니다. 기본적으로 설정되지 않으며 ft-sdk 1.6.7 이상에서 지원합니다. Resource 사용자 정의
addGlobalContext Dictionary 아니요 사용자 모니터링 데이터 소스 구분을 위한 사용자 정의 태그를 추가합니다. 추적 기능을 사용해야 하는 경우 매개변수 key는 track_id, value는 임의의 숫자입니다. 추가 규칙 유의 사항은 여기를 참조하세요.
setVisitorIdConfig FTVisitorIdConfig 아니요 익명 방문자 식별자 Visitor ID를 구성합니다. 기본값은 null(비활성화)입니다. 유효한 구성을 전달하면 활성화되며, OkHttp Header 주입은 RUM/Trace 샘플링 및 Resource 수집 스위치와 독립적입니다. ft-sdk >= 1.7.6-alpha04에서 지원합니다. 자세한 내용은 방문자 식별자 Visitor ID를 참조하세요.
setRumCacheLimitCount int 아니요 로컬 캐시 RUM 제한 수량 [10_000,), 기본값은 100_000입니다. ft-sdk 1.6.6 이상에서 지원합니다.
setEnableTraceWebView Boolean 아니요 Android SDK를 통한 WebView 데이터 수집 활성화 여부. 기본값은 true이며 ft-sdk 1.6.12 이상에서 지원합니다.
setAllowWebViewHost Array 아니요 데이터 추적을 허용하는 WebView host 주소를 설정합니다. null이면 전체 수집이며 기본값은 null입니다. ft-sdk 1.6.12 이상에서 지원합니다. 이 메서드는 지원 중단되었으며, ft-sdk 1.7.5부터는 FTSDKConfig.setAllowWebViewHost를 사용하여 WebView RUM과 Log를 통합 구성하세요.
setViewActivityTrackingHandler FTViewActivityTrackingHandler 아니요 Activity 뷰 추적 방식을 사용자 정의합니다. Activity 수명 주기 이벤트가 발생하면 이 핸들러가 호출되어 해당 Activity를 추적할 방법을 결정합니다. 기본적으로 아무 작업도 하지 않으며 ft-sdk 1.6.13 이상에서 지원합니다.
setViewFragmentTrackingHandler FTViewFragmentTrackingHandler 아니요 Fragment 뷰 추적 방식을 사용자 정의합니다. Fragment 수명 주기 이벤트가 발생하면 이 핸들러가 호출되어 해당 Fragment를 추적할 방법을 결정합니다. 기본적으로 아무 작업도 하지 않으며 ft-sdk 1.6.13 이상에서 지원합니다.
setActionTrackingHandler FTActionTrackingHandler 아니요 사용자 작업 추적 방식을 사용자 정의합니다. 사용자가 작업을 수행하면 이 핸들러가 호출되어 해당 작업을 추적할 방법을 결정합니다. 기본적으로 아무 작업도 하지 않으며 ft-sdk 1.6.13 이상에서 지원합니다.

RUM 수동 계측

FTRUMConfig에서 enableTraceUserAction, enableTraceUserView, enableTraceUserResource, setEnableTrackAppUIBlock, setEnableTrackAppCrash, setEnableTrackAppANR를 구성하여 Action, View, Resource, LongTask, Error를 자동 수집할 수 있습니다. 사용자 정의 수집이 필요한 경우 FTRUMGlobalManager를 통해 수동으로 업로드할 수 있습니다.

Action

사용 방법

/**
 * Action 추가
 *
 * @param actionName action 이름
 * @param actionType action 유형
 * @param property   추가 속성 매개변수(선택)
 */
public void startAction(String actionName, String actionType, HashMap<String, Object> property)

/**
 * Action 추가, 이 유형의 데이터는 Error, Resource, LongTask 데이터와 연결할 수 없음
 *
 * @param actionName action 이름
 * @param actionType action 유형
 * @param duration   나노초, 지속 시간(선택)
 * @param property   확장 속성(선택)
 */
public void addAction(String actionName, String actionType, long duration, HashMap<String, Object> property)
/**
 * action 추가
 *
 * @param actionName action 이름
 * @param actionType action 유형
 * @param property   추가 속성 매개변수(선택)
 */
fun startAction(actionName: String, actionType: String, property: HashMap<String, Any>)

/**
 * Action 추가
 *
 * @param actionName action 이름
 * @param actionType action 유형
 * @param duration   나노초, 지속 시간(선택)
 * @param property   확장 속성(선택)
 */
fun addAction(actionName: String, actionType: String, duration: Long, property: HashMap<String, Any>)

startAction에는 내부적으로 소요 시간 계산 알고리즘이 있으며, 계산 중에 주변에서 발생한 Resource, LongTask, Error 데이터와 최대한 데이터 연결을 수행합니다. 100ms 빈번 호출 보호가 설정되어 있어 사용자 작업 유형의 데이터에 사용하는 것이 좋습니다. 빈번한 호출이 필요한 경우 addAction을 사용하세요. 이 데이터는 startAction과 충돌하지 않으며 현재 Resource, LongTask, Error와 데이터 연결을 수행하지 않습니다.

코드 예시

// 시나리오 1
FTRUMGlobalManager.get().startAction("login", "action_type");

// 시나리오 2: 동적 매개변수
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().startAction("login", "action_type", map);

// 시나리오 1
FTRUMGlobalManager.get().addAction("login", "action_type");

// 시나리오 2: 동적 매개변수
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addAction("login", "action_type", map);
// 시나리오 1
FTRUMGlobalManager.get().startAction("login", "action_type")

// 시나리오 2: 동적 매개변수
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().startAction("login", "action_type", map)

// 시나리오 1
FTRUMGlobalManager.get().addAction("login", "action_type")

// 시나리오 2: 동적 매개변수
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addAction("login", "action_type", map)

View

사용 방법

/**
 * view 시작
 *
 * @param viewName 현재 페이지 이름
 * @param property 추가 속성 매개변수(선택)
 */
public void startView(String viewName, HashMap<String, Object> property)

/**
 * view 종료
 *
 * @param property 추가 속성 매개변수(선택)
 */
public void stopView(HashMap<String, Object> property)

/**
 * 현재 view loading_time 지표 업데이트, 단위 나노초
 *
 * @param duration duration
 */
public void updateLoadTime(long duration)
/**
 * view 시작
 *
 * @param viewName 현재 페이지 이름
 * @param property 추가 속성 매개변수(선택)
 */
fun startView(viewName: String, property: HashMap<String, Any>)

/**
 * view 종료
 *
 * @param property 추가 속성 매개변수(선택)
 */
fun stopView(property: HashMap<String, Any>)

/**
 * 현재 view loading_time 지표 업데이트, 단위 나노초
 *
 * @param duration duration
 */
fun updateLoadTime(duration: Long)

코드 예시

@Override
protected void onResume() {
    super.onResume();

    // 시나리오 1
    FTRUMGlobalManager.get().startView("Current Page Name");

    // 시나리오 2: 동적 매개변수
    HashMap<String, Object> map = new HashMap<>();
    map.put("ft_key", "ft_value");
    map.put("ft_key_will_change", "ft_value");
    FTRUMGlobalManager.get().startView("Current Page Name", map)
}

@Override
protected void onPause() {
    super.onPause();

    // 시나리오 1
    FTRUMGlobalManager.get().stopView();

    // 시나리오 2 : 동적 매개변수
    HashMap<String, Object> map = new HashMap<>();
    map.put("ft_key_will_change", "ft_value_change"); //ft_key_will_change 값은 stopView 시 ft_value_change로 업데이트됩니다.
    FTRUMGlobalManager.get().stopView(map);

}
override fun onResume() {
    super.onResume()

    // 시나리오 1
    FTRUMGlobalManager.get().startView("Current Page Name")

    // 시나리오 2: 동적 매개변수
    val map = HashMap<String, Any>()
    map["ft_key"] = "ft_value"
    map["ft_key_will_change"] = "ft_value"
    FTRUMGlobalManager.get().startView("Current Page Name", map)
}

override fun onPause() {
    super.onPause()

    // 시나리오 1
    FTRUMGlobalManager.get().stopView()

    // 시나리오 2 : 동적 매개변수
    val map = HashMap<String, Any>()
    map["ft_key_will_change"] = "ft_value_change" // ft_key_will_change 값은 stopView 시 ft_value_change로 변경됩니다.
    FTRUMGlobalManager.get().stopView(map)
}

Error

사용 방법

/**
 * 오류 정보 추가
 *
 * @param log       로그
 * @param message   메시지
 * @param errorType 오류 유형, ErrorType
 * @param state     프로그램 실행 상태
 * @param dateline  발생 시간, 나노초(선택)
 * @param property  추가 속성(선택)
 */
public void addError(String log, String message, long dateline, ErrorType errorType,
                     AppState state, HashMap<String, Object> property)

/**
 * 오류 정보 추가
 *
 * @param log       로그
 * @param message   메시지
 * @param errorType 오류 유형, String
 * @param state     프로그램 실행 상태
 * @param dateline  발생 시간, 나노초(선택)
 * @param property  추가 속성(선택)
 */
public void addError(String log, String message, long dateline, String errorType,
                     AppState state, HashMap<String, Object> property)
/**
 * 오류 정보 추가
 *
 * @param log       로그
 * @param message   메시지
 * @param errorType 오류 유형, ErrorType
 * @param state     프로그램 실행 상태
 * @param dateline  발생 시간, 나노초(선택)
 * @param property  추가 속성(선택)
 */
fun addError(log: String, message: String, dateline: Long, errorType: ErrorType, state: AppState, property: HashMap<String, Any>)

/**
 * 오류 정보 추가
 *
 * @param log       로그
 * @param message   메시지
 * @param errorType 오류 유형, String
 * @param state     프로그램 실행 상태
 * @param dateline  발생 시간, 나노초(선택)
 * @param property  추가 속성(선택)
 */
fun addError(log: String, message: String, dateline: Long, errorType: String, state: AppState, property: HashMap<String, Any>)

코드 예시

// 시나리오 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN);

// 시나리오 2: 발생한 오류를 지연 기록합니다. 여기서 시간은 일반적으로 오류 발생 시간입니다.
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000L, ErrorType.JAVA, AppState.RUN);

// 시나리오 3: 동적 매개변수
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map);
// 시나리오 1:
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN)

// 시나리오 2: 발생한 오류를 지연 기록합니다. 여기서 시간은 일반적으로 오류 발생 시간입니다.
FTRUMGlobalManager.get().addError("error log", "error msg", 16789000000000000000, ErrorType.JAVA, AppState.RUN)

// 시나리오 3: 동적 매개변수
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addError("error log", "error msg", ErrorType.JAVA, AppState.RUN, map)

LongTask

사용 방법

/**
 * 긴 작업 추가
 *
 * @param log      로그 내용
 * @param duration 지속 시간, 나노초
 * @param property 추가 속성 매개변수(선택)
 */
public void addLongTask(String log, long duration, HashMap<String, Object> property)
/**
 * 긴 작업 추가
 *
 * @param log      로그 내용
 * @param duration 지속 시간, 나노초
 * @param property 추가 속성 매개변수(선택)
 */
fun addLongTask(log: String, duration: Long, property: HashMap<String, Any>)

코드 예시

// 시나리오 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L);

// 시나리오 2: 동적 매개변수
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTRUMGlobalManager.get().addLongTask("", 1000000L, map);
// 시나리오 1
FTRUMGlobalManager.get().addLongTask("error log", 1000000L)

// 시나리오 2: 동적 매개변수
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTRUMGlobalManager.get().addLongTask("", 1000000L, map)

Resource

사용 방법

/**
 * resource 시작
 *
 * @param resourceId 리소스 Id
 * @param property   추가 속성 매개변수(선택)
 */
public void startResource(String resourceId, HashMap<String, Object> property)

/**
 * resource 종료
 *
 * @param resourceId 리소스 Id
 * @param property   추가 속성 매개변수(선택)
 */
public void stopResource(final String resourceId, HashMap<String, Object> property)

/**
 * 네트워크 전송 내용 설정
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
public void addResource(String resourceId, ResourceParams params, NetStatusBean netStatusBean)
/**
 * resource 시작
 *
 * @param resourceId 리소스 Id(선택)
 */
fun startResource(resourceId: String, property: HashMap<String, Any>)

/**
 * resource 종료
 *
 * @param resourceId 리소스 Id
 * @param property   추가 속성 매개변수(선택)
 */
fun stopResource(resourceId: String, property: HashMap<String, Any>)

/**
 * 네트워크 전송 내용 설정
 *
 * @param resourceId resourceId
 * @param params params
 * @param netStatusBean netStatusBean
 */
fun addResource(resourceId: String, params: ResourceParams, netStatusBean: NetStatusBean)

코드 예시

// 시나리오 1
// 요청 시작
FTRUMGlobalManager.get().startResource("resourceId");

// ...

// 요청 종료
FTRUMGlobalManager.get().stopResource("resourceId");

// 마지막으로, 요청 종료 후 요청 관련 데이터 지표를 전송합니다.
ResourceParams params = new ResourceParams();
params.setUrl("https://guance.com");
params.setResponseContentType(response.header("Content-Type"));
params.setResponseConnection(response.header("Connection"));
params.setResponseContentEncoding(response.header("Content-Encoding"));
params.setResponseHeader(response.headers().toString());
params.setRequestHeader(request.headers().toString());
params.setResourceStatus(response.code());
params.setResourceMethod(request.method());

NetStatusBean bean = new NetStatusBean();
bean.setTcpStartTime(60000000);
// ...

FTRUMGlobalManager.get().addResource("resourceId", params, bean);

// 시나리오 2: 동적 매개변수 사용
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
map.put("ft_key_will_change", "ft_value");

FTRUMGlobalManager.get().startResource("resourceId", map);

// ...
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key_will_change", "ft_value_change"); // ft_key_will_change 값은 stopResource 시 ft_value_change로 변경됩니다.
FTRUMGlobalManager.get().stopResource(uuid, map);
// 시나리오 1
// 요청 시작
FTRUMGlobalManager.get().startResource("resourceId")

// 요청 종료
FTRUMGlobalManager.get().stopResource("resourceId")

// 마지막으로, 요청 종료 후 요청 관련 데이터 지표를 전송합니다.
val params = ResourceParams()
params.url = "https://guance.com"
params.responseContentType = response.header("Content-Type")
params.responseConnection = response.header("Connection")
params.responseContentEncoding = response.header("Content-Encoding")
params.responseHeader = response.headers.toString()
params.requestHeader = request.headers.toString()
params.resourceStatus = response.code
params.resourceMethod = request.method

val bean = NetStatusBean()
bean.tcpStartTime = 60000000
// ...
FTRUMGlobalManager.get().addResource("resourceId", params, bean)

// 시나리오 2: 동적 매개변수 사용
val map = hashMapOf<String, Any>(
    "ft_key" to "ft_value",
    "ft_key_will_change" to "ft_value"
)
FTRUMGlobalManager.get().startResource("resourceId", map)

// ...
val map = hashMapOf<String, Any>(
    "ft_key_will_change" to "ft_value_change"
)
// ft_key_will_change 값은 stopResource 시 ft_value_change로 변경됩니다.

FTRUMGlobalManager.get().stopResource(uuid, map)
메서드명 필수 의미 설명
NetStatusBean.fetchStartTime 아니요 요청 시작 시간
NetStatusBean.tcpStartTime 아니요 TCP 연결 시간
NetStatusBean.tcpEndTime 아니요 TCP 종료 시간
NetStatusBean.dnsStartTime 아니요 DNS 시작 시간
NetStatusBean.dnsEndTime 아니요 DNS 종료 시간
NetStatusBean.responseStartTime 아니요 응답 시작 시간
NetStatusBean.responseEndTime 아니요 응답 종료 시간
NetStatusBean.sslStartTime 아니요 SSL 시작 시간
NetStatusBean.sslEndTime 아니요 SSL 종료 시간
NetStatusBean.property 아니요 추가 속성
ResourceParams.url 예 URL 주소
ResourceParams.requestHeader 아니요 요청 헤더 매개변수
ResourceParams.responseHeader 아니요 응답 헤더 매개변수
ResourceParams.responseConnection 아니요 응답 connection
ResourceParams.responseContentType 아니요 응답 ContentType
ResourceParams.responseContentEncoding 아니요 응답 ContentEncoding
ResourceParams.resourceMethod 아니요 요청 메서드 GET, POST 등
ResourceParams.responseBody 아니요 반환된 body 내용
ResourceParams.property 아니요 추가 속성

Resource 자동 수집

네트워크 요청 자동 수집에는 ft-plugin 연동이 필요하며, RUM 초기화 시 setEnableTraceUserResource(true)를 활성화해야 합니다. Resource URL 필터링 및 RUM 샘플링 규칙은 아래의 모든 수집 방식에 적용됩니다.

OkHttp

setEnableTraceUserResource(true)를 활성화하면 SDK가 플러그인으로 계측된 OkHttp HTTP/HTTPS 요청을 자동으로 수집하며, 요청 코드를 수정할 필요가 없습니다. OkHttpClient를 생성하기 전에 SDK 초기화를 완료하세요.

플러그인을 사용하지 않는 경우 OkHttp Resource / Trace 수동 연동에 따라 구성할 수 있습니다.

HttpURLConnection / HttpsURLConnection

ft-sdk >= 1.7.6-alpha03 및 ft-plugin >= 1.3.9-alpha01이 필요합니다. 연결을 생성하기 전에 다음 두 스위치를 모두 활성화하세요.

FTSdk.initRUMWithConfig(new FTRUMConfig()
    .setRumAppId(RUM_APP_ID)
    .setEnableTraceUserResource(true)
    .setEnableHttpURLConnectionResource(true));
FTSdk.initRUMWithConfig(
    FTRUMConfig()
        .setRumAppId(RUM_APP_ID)
        .setEnableTraceUserResource(true)
        .setEnableHttpURLConnectionResource(true)
)
  • 수집 범위: 플러그인으로 계측된 URL.openConnection() 및 openConnection(Proxy) HTTP/HTTPS 요청. 플러그인 옵션 instrumentHttpURLConnection은 기본적으로 활성화됩니다. 리플렉션, 시스템 내부 또는 계측에서 제외된 호출은 수집되지 않습니다.
  • 수집 데이터: URL, 메서드, 요청 헤더, 응답 헤더, 상태 코드, 실제 읽기/쓰기 바이트 수 및 총 소요 시간. 본문, DNS/TCP/TLS 단계별 소요 시간 및 대상 IP는 수집하지 않습니다. 총 소요 시간에는 앱이 응답 스트림을 읽는 시간이 포함되며, 응답을 모두 읽지 않은 경우 바이트 수가 전체 응답 크기보다 작을 수 있습니다.
  • 사용 시 주의: 응답 스트림을 정상적으로 읽고 닫은 후, 요청이 끝나면 disconnect()를 호출하세요. SSE 등 장기 연결 요청은 필터링하는 것이 좋습니다. 다른 수집 레이어와 동시에 사용할 때는 중복 업로드를 피하세요.
  • 연동 기능: Trace Header 주입 및 RUM 분산 추적 연동은 별도로 구성해야 합니다. URLConnection Trace를 참조하세요. Visitor ID Header 주입은 지원하지 않습니다.

WebSocket 핸드셰이크 Resource

ft-sdk >= 1.7.5 및 ft-plugin >= 1.3.8이 필요합니다. setEnableTraceUserResource(true)를 활성화하면 OkHttp newWebSocket()의 핸드셰이크 요청이 자동으로 수집되며, 추가 스위치는 필요 없습니다.

각 핸드셰이크마다 하나의 Resource가 생성되며 성공, 거부 또는 실패 상태가 기록됩니다. 연결 지속 시간은 집계하지 않으며 메시지 내용도 수집하지 않습니다. 자동 수집을 지원하는 플러그인을 사용하지 않는 경우 FTWebSocket을 통해 수동 연동할 수 있습니다.

문서 평가

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