Log 설정¶
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 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 샘플링을 다음과 같이 마이그레이션합니다:
Logger 로그 출력¶
사용자 정의 로그¶
현재 로그 내용은 30 KB로 제한되며, 초과된 문자는 잘립니다.
사용 방법¶
/// 로그 출력
/// [content] 로그 내용
/// [status] 로그 상태
/// [property] 추가 속성 매개변수(선택 사항)
Future<void> logging(String content, FTLogStatus status,
{Map<String, String>? property})
코드 예시¶
로그 레벨¶
| 메서드 이름 | 의미 |
|---|---|
| FTLogStatus.info | 정보 |
| FTLogStatus.warning | 경고 |
| FTLogStatus.error | 오류 |
| FTLogStatus.critical | 심각 |
| FTLogStatus.ok | 복구 |