콘텐츠로 이동

Log 설정

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

Log 초기화 설정

FTSdk.initLogWithConfig(new FTLoggerConfig()
    //.setEnableConsoleLog(true, "log prefix")
    .setEnableLinkRumData(true)
    .setEnableCustomLog(true)
    .setEnableWebViewLog(true)
    //.setLogLevelFilters(new Status[]{Status.CRITICAL, Status.ERROR})
    .setLogSamplingRate(80f));
FTSdk.initLogWithConfig(
    FTLoggerConfig()
        //.setEnableConsoleLog(true, "log prefix")
        .setEnableLinkRumData(true)
        .setEnableCustomLog(true)
        .setEnableWebViewLog(true)
        //.setLogLevelFilters(arrayOf(Status.CRITICAL, Status.ERROR))
        .setLogSamplingRate(80f)
)
메서드명 유형 필수 설명
setLogSamplingRate 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입니다.
setEnableConsoleLog Boolean 아니요 콘솔 로그 업로드 여부, 이 설정은 ft-plugin에 의존하며 기본값은 false입니다. 로그 레벨 대응 관계: Log.v -> ok, Log.i -> info, Log.d -> debug, Log.e -> error, Log.w -> warning. prefix는 접두사 필터링을 제어하는 매개변수이며 기본적으로 필터링을 설정하지 않습니다. 참고: Android 콘솔 로그는 데이터량이 매우 많습니다. 앱 성능에 영향을 주고 불필요한 리소스 낭비를 줄이려면 prefix를 사용하여 가치 있는 로그를 필터링할 것을 권장합니다. ft-plugin 1.3.5 이상 버전에서는 Log.println으로 출력한 로그 캡처를 지원합니다.
setEnableWebViewLog Boolean 아니요 WebView에서 Browser SDK가 생성한 로그 수집 여부, 기본값은 false, ft-sdk 1.7.5 이상에서 지원합니다. 이 설정은 setEnableCustomLog 및 setEnableConsoleLog와 독립적이며, 연동 방법은 WebView 로그 수집을 참조하세요.
setEnableLinkRumData Boolean 아니요 RUM 데이터 연결 여부, 기본값은 false
setEnableCustomLog Boolean 아니요 사용자 정의 로그 업로드 여부, 기본값은 false
setLogLevelFilters Array 아니요 레벨 로그 필터 설정, 기본적으로 미설정
addGlobalContext Dictionary 아니요 log 전역 속성 추가, 추가 규칙은 여기를 참조하세요.
setLogCacheLimitCount Int 아니요 로컬 캐시 최대 로그 항목 수 제한 [1000,), 로그가 많을수록 디스크 캐시 부담이 커지며 기본값은 5000입니다.
setLogCacheDiscardStrategy LogCacheDiscard 아니요 로그가 제한 상한에 도달한 이후의 로그 폐기 규칙을 설정합니다. 기본값은 LogCacheDiscard.DISCARD이며, DISCARD는 추가 데이터 폐기, DISCARD_OLDEST는 오래된 데이터 폐기를 의미합니다.

Logger 로그 출력

FTLogger를 사용하여 사용자 정의 로그를 출력하려면 FTLoggerConfig.setEnableCustomLog(true)를 활성화해야 합니다.

현재 로그 내용은 30KB로 제한되며, 초과하는 문자는 잘립니다.

사용 방법

/**
 * 단일 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param content 로그 내용
 * @param status  로그 레벨, enum Status
 * @param property 추가 속성(선택 사항)
 */
public void logBackground(String content, Status status, HashMap<String, Object> property)

/**
 * 단일 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param content 로그 내용
 * @param status  로그 레벨, String
 * @param property 추가 속성(선택 사항)
 */
public void logBackground(String content, String status, HashMap<String, Object> property)

/**
 * 여러 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param logDataList {@link LogData} 목록
 */
public void logBackground(List<LogData> logDataList)
/**
 * 단일 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param content 로그 내용
 * @param status  로그 레벨
 * @param property 로그 속성(선택 사항)
 */
fun logBackground(content: String, status: Status, property: HashMap<String, Any>)

/**
 * 단일 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param content 로그 내용
 * @param status  로그 레벨
 * @param property 로그 속성(선택 사항)
 */
fun logBackground(content: String, status: String, property: HashMap<String, Any>)

/**
 * 여러 로그 데이터를 로컬에 동기 저장합니다.
 *
 * @param logDataList 로그 데이터 목록
 */
fun logBackground(logDataList: List<LogData>)

로그 레벨

메서드명 설명
Status.DEBUG 디버그
Status.INFO 정보
Status.WARNING 경고
Status.ERROR 오류
Status.CRITICAL 치명
Status.OK 복구

코드 예시

// 단일 로그 업로드
FTLogger.getInstance().logBackground("test", Status.INFO);

// HashMap에 매개변수 전달
HashMap<String, Object> map = new HashMap<>();
map.put("ft_key", "ft_value");
FTLogger.getInstance().logBackground("test", Status.INFO, map);

// 로그 일괄 업로드
List<LogData> logList = new ArrayList<>();
logList.add(new LogData("test", Status.INFO));
FTLogger.getInstance().logBackground(logList);
// 단일 로그 업로드
FTLogger.getInstance().logBackground("test", Status.INFO)

// HashMap에 매개변수 전달
val map = HashMap<String, Any>()
map["ft_key"] = "ft_value"
FTLogger.getInstance().logBackground("test", Status.INFO, map)

// 로그 일괄 업로드
FTLogger.getInstance().logBackground(mutableListOf(LogData("test", Status.INFO)))

문서 평가

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