콘텐츠로 이동

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]?)
}

로그 레벨

/// 이벤트 레벨 및 상태, 기본값: FTStatusInfo
typedef NS_ENUM(NSInteger, FTLogStatus) {
    /// 정보
    FTStatusInfo         = 0,
    /// 경고
    FTStatusWarning,
    /// 오류
    FTStatusError,
    /// 심각
    FTStatusCritical,
    /// 복구
    FTStatusOk,
};
/// 이벤트 레벨 및 상태, 기본값: FTStatusInfo
public enum FTLogStatus : Int, @unchecked Sendable {
    /// 정보
    case statusInfo = 0
    /// 경고
    case statusWarning = 1
    /// 오류
    case statusError = 2
    /// 심각
    case statusCritical = 3
    /// 복구
    case statusOk = 4
}

코드 예시

// SDK가 성공적으로 초기화되지 않으면 사용자 정의 로그 추가가 실패합니다
[[FTLogger sharedInstance] info:@"test" property:@{@"custom_key":@"custom_value"}];
// SDK가 성공적으로 초기화되지 않으면 사용자 정의 로그 추가가 실패합니다
FTLogger.shared().info("contentStr", property: ["custom_key":"custom_value"])

사용자 정의 로그 콘솔 출력

printCustomLogToConsole = YES를 설정하여 사용자 정의 로그를 콘솔에 출력하도록 활성화하면 Xcode 디버그 콘솔에서 다음 형식의 로그를 볼 수 있습니다.

iOS/tvOS:

2023-06-29 13:47:56.960021+0800 App[64731:44595791] [IOS APP] [INFO] content ,{K=V,...,Kn=Vn}

macOS:

2023-06-29 13:47:56.960021+0800 App[64731:44595791] [MACOS APP] [INFO] content ,{K=V,...,Kn=Vn}

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}: 사용자 정의 속성입니다.

문서 평가

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