Log 설정¶
Log 초기화 설정¶
// logger 활성화
FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc]init];
loggerConfig.enableCustomLog = YES;
loggerConfig.enableLinkRumData = YES;
loggerConfig.logLevelFilter = @[@(FTStatusError),@(FTStatusCritical)];
loggerConfig.discardType = FTDiscardOldest;
[[FTMobileAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];
let loggerConfig = FTLoggerConfig()
loggerConfig.enableCustomLog = true
loggerConfig.enableLinkRumData = true
loggerConfig.logLevelFilter = [NSNumber(value: FTLogStatus.statusError.rawValue),NSNumber(value: FTLogStatus.statusCritical.rawValue)] // loggerConfig.logLevelFilter = [2,3]
loggerConfig.discardType = .discardOldest
FTMobileAgent.sharedInstance().startLogger(withConfigOptions: loggerConfig)
| 속성 | 유형 | 필수 | 의미 |
|---|---|---|---|
| logSamplingRate | float | 아니요 | Log 샘플링 레이트, 범위 [0,100], 소수 지원, 기본값 100. 0.1은 0.1%, 1은 1%를 의미합니다. SDK 1.6.8부터 지원됩니다. |
| sampleRate | int | 아니요 | SDK 1.6.8부터 사용 중단되었으며 호환성을 위해 유지됩니다. 정수 백분율 샘플링 레이트, 범위 [0,100], 기본값 100. logSamplingRate 사용을 권장합니다. |
| enableWebViewLog | BOOL | 아니요 | SDK 1.6.8+: WebView에서 Browser Logs SDK가 생성한 로그를 수신합니다. 기본값 NO, enableCustomLog와 독립적입니다. Web 측은 여전히 로그 SDK를 초기화해야 합니다. WebView 로그 참고 |
| enableCustomLog | BOOL | 아니요 | 사용자 정의 log 업로드 여부. 기본값 NO |
| printCustomLogToConsole | BOOL | 아니요 | 사용자 정의 로그를 콘솔에 출력할지 설정합니다. 기본값 NO, 사용자 정의 로그 출력 형식 |
| logLevelFilter | NSArray | 아니요 | 레벨 로그 필터링을 설정하며 기본적으로 설정하지 않습니다. 예: 1. 로그 레벨이 Info와 Error인 로그를 수집하려면 @[@(FTStatusInfo),@(FTStatusError)] 또는 @[@0,@1]로 설정합니다. 2. 수집할 로그 레벨에 사용자 정의 레벨이 포함된 경우, 예를 들어 "customLevel"과 Error를 수집하려면 @[@"customLevel",@(FTStatusError)]로 설정합니다. SDK 1.5.16 이상 버전은 사용자 정의 레벨 필터링을 지원합니다. |
| enableLinkRumData | BOOL | 아니요 | RUM 데이터와 연결할지 여부. 기본값 NO |
| globalContext | NSDictionary | 아니요 | log 사용자 정의 태그를 추가합니다. 추가 규칙은 여기를 참고하세요. |
| logCacheLimitCount | int | 아니요 | 로컬 캐시 최대 로그 항목 수 제한 [1000,), 로그가 많을수록 디스크 캐시 부하가 커집니다. 기본값 5000 |
| discardType | FTLogCacheDiscard | 아니요 | 로그가 제한 상한에 도달한 후의 로그 폐기 규칙을 설정합니다. 기본값 FTDiscard. FTDiscard는 로그 데이터 수가 최대값(5000)보다 클 때 추가 데이터를 폐기합니다. FTDiscardOldest는 로그 데이터가 최대값보다 클 때 오래된 데이터를 폐기합니다. |
샘플링 레이트 파라미터 이름 지정
SDK 1.6.8 이상에서는 logSamplingRate 사용을 권장하며, 값은 0~100의 백분율이고 소수를 지원합니다. 유효하지 않은 값(범위 초과, NaN, 무한대)은 기존 설정을 덮어쓰지 않습니다. 기존 sampleRate / samplerate는 정수 백분율만 지원하며 사용 중단으로 표시되었고 향후 버전에서 제거될 수 있습니다. 기존 getter를 통해 소수 샘플링 레이트를 읽으면 정수 부분이 반환됩니다.
원격 샘플링 필드의 단위와 우선순위는 원격 설정 필드를 참고하세요.
Logger 로그 출력¶
SDK 초기화 시 Log 설정에서 enableCustomLog를 설정하면 사용자 정의 로그 추가를 허용합니다.
현재 로그 내용은 30 KB로 제한되며, 초과된 문자는 잘라냅니다.
사용 방법¶
//
// FTLogger.h
// GuanceSDK
/// info 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
-(void)info:(NSString *)content property:(nullable NSDictionary *)property;
/// warning 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
-(void)warning:(NSString *)content property:(nullable NSDictionary *)property;
/// error 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
-(void)error:(NSString *)content property:(nullable NSDictionary *)property;
/// critical 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
-(void)critical:(NSString *)content property:(nullable NSDictionary *)property;
/// ok 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
-(void)ok:(NSString *)content property:(nullable NSDictionary *)property;
/// 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - status: 로그 상태 레벨
/// - property: 사용자 정의 속성(선택 사항)
- (void)log:(NSString *)content status:(NSString *)status property:(nullable NSDictionary *)property;
open class FTLogger : NSObject, FTLoggerProtocol {}
public protocol FTLoggerProtocol : NSObjectProtocol {
/// info 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
optional func info(_ content: String, property: [AnyHashable : Any]?)
/// warning 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
optional func warning(_ content: String, property: [AnyHashable : Any]?)
/// error 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
optional func error(_ content: String, property: [AnyHashable : Any]?)
/// critical 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
optional func critical(_ content: String, property: [AnyHashable : Any]?)
/// ok 레벨 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - property: 사용자 정의 속성(선택 사항)
optional func ok(_ content: String, property: [AnyHashable : Any]?)
/// 사용자 정의 로그 추가
/// - Parameters:
/// - content: 로그 내용
/// - status: 로그 상태 레벨
/// - property: 사용자 정의 속성(선택 사항)
optional func log(_ content: String, status: String, property: [AnyHashable : Any]?)
}
로그 레벨¶
코드 예시¶
사용자 정의 로그 콘솔 출력¶
printCustomLogToConsole = YES를 설정하여 사용자 정의 로그를 콘솔에 출력하도록 활성화하면 Xcode 디버그 콘솔에서 다음 형식의 로그를 볼 수 있습니다.
iOS/tvOS:
macOS:
2023-06-29 13:47:56.960021+0800 App[64731:44595791]: os_log 로그 출력의 표준 접두사입니다.
[IOS APP] / [MACOS APP]: SDK가 사용자 정의 로그를 출력할 때 사용하는 접두사로, 실행 플랫폼에 따라 SDK가 접두사를 선택합니다.
[INFO]: 사용자 정의 로그의 레벨입니다.
content: 사용자 정의 로그 내용입니다.
{K=V,...,Kn=Vn}: 사용자 정의 속성입니다.