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