콘텐츠로 이동

Log 설정

await FTLogger().logConfig(
  enableCustomLog: true,
);
필드 유형 필수 설명
logSamplingRate double 아니요 Log 샘플링 비율로, 범위는 [0,100]이며 소수를 지원합니다. 기본값은 100입니다. 0.1은 0.1%, 1은 1%를 의미합니다. SDK 0.5.8부터 지원됩니다.
sampleRate double 아니요 이전 확률 설정으로, 호환성을 위해 유지됩니다. Log 샘플링 비율로, 범위는 [0,1]이며 기본값은 1입니다. 0.1은 10%, 1은 100%를 의미합니다. logSamplingRate 사용을 권장합니다.
enableWebViewLog bool 아니요 WebView 내 Web 모니터링 SDK의 로그 수집 여부이며 기본값은 false입니다. 기본 설정의 allowWebViewHost 및 페이지의 Web 모니터링 SDK와 함께 사용해야 합니다. SDK 0.5.8부터 지원되며, 자세한 내용은 WebView 데이터 모니터링을 참조하십시오.
enableLinkRumData bool 아니요 RUM과 연결할지 여부
enableCustomLog bool 아니요 사용자 정의 로그 활성화 여부
logLevelFilters List<FTLogStatus> 아니요 로그 레벨 필터
logCacheLimitCount int 아니요 로컬 캐시의 최대 로그 항목 수 제한 [1000, ), 기본값 5000
discardStrategy enum FTLogCacheDiscard 아니요 로그가 제한 상한에 도달한 후의 폐기 규칙을 설정합니다. 기본값은 FTLogCacheDiscard.discard이며, discard는 추가 데이터를 폐기하고 discardOldest는 오래된 데이터를 폐기합니다.

백분율 샘플링 마이그레이션

SDK 0.5.8부터 지원됩니다.

샘플링 비율 매개변수 이름

SDK 0.5.8부터 logSamplingRate 사용을 권장합니다. 값은 0~100 범위의 백분율이며 소수를 지원합니다. 0은 샘플링하지 않음, 100은 전체 샘플링을 의미합니다. 범위를 벗어난 값, NaN 또는 무한대와 같은 유효하지 않은 값은 ArgumentError를 발생시킵니다.

기존 sampleRate는 호환성을 위해 계속 유지되며, 값은 0~1 범위의 확률입니다. 예를 들어 기존 필드의 0.1은 10%, 새 필드의 0.1은 0.1%를 의미합니다. 새 필드와 기존 필드를 동시에 설정하면 명시적인 0을 포함하여 새 백분율 필드가 우선합니다.

원격 샘플링 필드의 단위와 우선순위는 Flutter 원격 설정 필드를 참조하십시오.

예를 들어 12.5%의 Log 샘플링을 다음과 같이 마이그레이션합니다:

 await FTLogger().logConfig(
   enableCustomLog: true,
-  sampleRate: 0.125,
+  logSamplingRate: 12.5,
 );

Logger 로그 출력

사용자 정의 로그

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

사용 방법

/// 로그 출력
/// [content] 로그 내용
/// [status] 로그 상태
/// [property] 추가 속성 매개변수(선택 사항)
Future<void> logging(String content, FTLogStatus status,
  {Map<String, String>? property})

코드 예시

FTLogger().logging("info log content", FTLogStatus.info);

로그 레벨

메서드 이름 의미
FTLogStatus.info 정보
FTLogStatus.warning 경고
FTLogStatus.error 오류
FTLogStatus.critical 심각
FTLogStatus.ok 복구

문서 평가

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