Log 설정¶
Log 초기화 설정¶
let logConfig: FTLogConfig = {
logSamplingRate: 100,
enableCustomLog: true,
enableLinkRumData: true,
};
await FTReactNativeLog.logConfig(logConfig);
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| logSamplingRate | number | 아니요 | 샘플링 비율(%)이며 범위는 [0,100]이고 소수점을 지원하며 기본값은 100입니다. sampleRate보다 우선 적용되며, 명시적으로 0으로 설정한 경우도 포함합니다. SDK 0.4.3부터 지원됩니다. |
| sampleRate | number | 아니요 | SDK 0.4.3부터 사용 중단되었으며 호환성을 위해 유지됩니다. 범위는 [0,1]이고 기본값은 1입니다. logSamplingRate가 설정되지 않은 경우에만 적용됩니다. logSamplingRate 사용을 권장합니다. |
| enableLinkRumData | boolean | 아니요 | RUM과 연동할지 여부 |
| enableCustomLog | boolean | 아니요 | 사용자 지정 로그 활성화 여부 |
| enableWebViewLog | boolean | 아니요 | WebView에서 Browser Logs SDK가 생성한 로그를 수신할지 여부이며 기본값은 false입니다. 원격 필드 logEnableWebViewLog가 로컬 스위치를 재정의할 수 있습니다. 자세한 내용은 WebView 로그를 참조하세요. SDK 0.4.3부터 지원됩니다. |
| logLevelFilters | Array |
아니요 | 로그 레벨 필터 |
| globalContext | NSDictionary | 아니요 | Log 사용자 지정 태그를 추가합니다. 추가 규칙은 여기를 참조하세요. |
| logCacheLimitCount | number | 아니요 | 로컬 캐시 최대 로그 항목 수 제한 [1000,)입니다. 로그가 많을수록 디스크 캐시 부담이 커지며 기본값은 5000입니다. |
| discardStrategy | enum FTLogCacheDiscard | 아니요 | 로그가 제한 상한에 도달한 후의 폐기 규칙을 설정합니다. 기본값은 FTLogCacheDiscard.discard이며, discard는 추가 데이터를 폐기하고 discardOldest는 오래된 데이터를 폐기합니다. |
SDK 0.4.3부터 소수점 비율 샘플링을 지원합니다. logSamplingRate: 12.5는 12.5%를, 1은 1%를, 100은 전체 수집을 의미합니다. 마이그레이션 규칙은 샘플링 설정을 참조하세요.
Logger 로그 출력¶
현재 로그 내용은 30 KB로 제한되며, 초과된 문자는 잘립니다.
사용 방법¶
/**
* 로그를 출력합니다.
* @param content 로그 내용
* @param logStatus 로그 상태
* @param property 로그 컨텍스트(선택 사항)
*/
logging(content: String, logStatus: FTLogStatus | String, property?: object): Promise<void>;
사용 예시¶
import { FTReactNativeLog, FTLogStatus } from '@cloudcare/react-native-mobile';
// logStatus: FTLogStatus
FTReactNativeLog.logging('info log content', FTLogStatus.info);
// logStatus: string
FTReactNativeLog.logging('info log content', 'info');
로그 레벨¶
| 메서드 이름 | 의미 |
|---|---|
| FTLogStatus.info | 정보 |
| FTLogStatus.warning | 경고 |
| FTLogStatus.error | 오류 |
| FTLogStatus.critical | 심각 |
| FTLogStatus.ok | 복구 |