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')
使用建议
- 调试阶段可结合
setEnableCustomLog(true) 和 SDK Debug 日志一起验证采集链路
- 若希望日志与用户行为、页面和资源数据串联分析,建议同时开启
setEnableLinkRumData(true)
- 若日志量较大,可通过采样率和级别过滤控制上报量