콘텐츠로 이동

Log 설정¶

이 문서는 HarmonyOS Log 초기화 설정을 설명합니다.

초기화 설정¶

import { FTSDK, FTLoggerConfig, Status } from '@guancecloud/ft_sdk/Index';

const logGlobalContext = new Map<string, string | number | boolean | object>();
logGlobalContext.set('demo_log_number_tag', 101);

const logConfig = new FTLoggerConfig()
  .setSamplingRate(1.0)
  .setEnableCustomLog(true)
  .setLogLevelFilters([
    Status.ERROR,
    Status.WARN,
    Status.INFO,
    Status.DEBUG
  ])
  .setEnableLinkRumData(true)
  .addGlobalContext(logGlobalContext)
  .setLogCacheLimitCount(10000);

FTSDK.installLogConfig(logConfig);

메서드	유형	필수	설명
`setSamplingRate`	`number`	아니요	로그 샘플링 비율, 범위 `[0.0, 1.0]`, 기본값 `1.0`
`setEnableCustomLog`	`boolean`	아니요	사용자 정의 로그 활성화 여부, 기본값 `false`
`setEnableLinkRumData`	`boolean`	아니요	RUM 데이터 연결 여부, 기본값 `false`
`setLogLevelFilters`	`Array<Status \| string \| { name: string }>`	아니요	로그 레벨 필터, 가능한 값: `ERROR`, `WARN`, `INFO`, `DEBUG`
`addGlobalContext`	`Dictionary`	아니요	log 전역 속성 추가, 추가 규칙은 여기를 참조하세요
`setLogCacheLimitCount`	`number`	아니요	로그 데이터 캐시 수 제한, 기본값 `5000`, 최소값 `1000`
`setLogCacheDiscardStrategy`	`LogCacheDiscard`	아니요	로그가 제한 상한에 도달한 후의 폐기 규칙 설정, 기본값은 `LogCacheDiscard.DISCARD`, `DISCARD`는 추가 데이터 폐기, `DISCARD_OLDEST`는 오래된 데이터 폐기

로그 레벨¶

메서드명	의미
Status.TRACE	추적
Status.DEBUG	디버그
Status.INFO	정보
Status.WARN	경고
Status.ERROR	오류
Status.FATAL	심각

Log 전역 속성 동적 추가¶

import { FTSDK } from '@guancecloud/ft_sdk/Index'

const dynamicContext = new Map<string, string | number | boolean | object>();
dynamicContext.set('user_level', 'vip')

FTSDK.appendLogGlobalContext(dynamicContext)
FTSDK.appendLogGlobalContextKeyValue('login_state', 'logged_in')

사용 권장 사항¶

setLogLevelFilters(...)는 FTLogger 비즈니스 Log의 보고 레벨을 제어하며, SDK 내부 진단 로그의 setSdkLogLevel(...)과는 독립적입니다.
디버그 단계에서는 setEnableCustomLog(true), setDebug(true) 및 SDK 디버그 로그를 함께 사용하여 수집 체인을 검증할 수 있습니다.
로그를 사용자 행동, 페이지 및 리소스 데이터와 함께 분석하려면 setEnableLinkRumData(true)를 함께 활성화하는 것이 좋습니다.
로그 양이 많을 경우 샘플링 비율과 레벨 필터를 통해 보고량을 제어할 수 있습니다.