tencent cloud

腾讯云可观测平台

SDK 初始化

下载
聚焦模式
字号
最后更新时间: 2026-05-25 18:01:57
本文将为您介绍如何初始化终端性能监控 Pro 日志 SDK。

初始化示例代码

通过 Builder 模式分别配置并初始化日志系统(TDLog)和诊断系统(TDDiag),设置日志路径、级别、大小限制等参数以及诊断所需的 AppId、环境、适配器等配置。
// Logger(可选)
TDLogConfig logConfig = new TDLogConfig.Builder(context)
.setLogPath(logPath) // 日志输出目录,需提前获取写权限
.setLogLevel(LogLevel.DEBUG) // 默认 VERBOSE
.setConsoleLog(true) // 默认 true
.setMaxFileSize(byte) // 默认50M
.setMaxAliveFileSize(byte) // 默认不限制,最小值200M
.setMaxAliveDay(day) // 默认7天, 最小值1天
.setPubKey(pubKey) // 日志加密公钥(可选,联系 RumPro 小助手提供公私钥给 RumPro 后台进行配置)
.build();
TDLog.initialize(context, logConfig);

// Diagnose
TDDiagConfig diagConfig = new TDDiagConfig.Builder()
.setAppId(appId) // 【重要】在 RumPro 申请的 AppId
.setAppKey(appKey) // 【重要】在 RumPro 平台申请的 AppKey
.setEnvironment(TDDiagConfig.ENV_CLOUD) // 【重要】设置环境(腾讯云版需设置为:TDDiagConfig.ENV_CLOUD)
.setLoggerAdapter(TDLog.getLogImpl()) // 业务可自行实现 LoggerAdapter 来适配自有日志工具
.setDeviceInfoAdapter(deviceInfoAdapter) // 按照隐私合规的要求,注入隐私信息(可选,默认从 android.os.Build 读取)
.setAppVersion("1.0.0") // 自定义 app 版本(可选,默认从 PackageInfo 读取)
.setTrafficQuota(total, metered) // 设置每日流量配额(可选,默认不限制,建议设置)
.setUploadCountLimit(limit, period, timeUnit) // 设置自动上报频率限制(可选,默认不限制,建议设置)
.setImportantLabels(...label) // 设置标签白名单(设置不受 TrafficQuota和UploadCountLimit 限制的标签)
.build();
TDDiag.initialize(context, config);
初始化完成后即可进行日志打印。
TDLog.i("tag", "xxxxxx");
TDLog.e("tag", "xxxxxx", e);
TDLog 和 TDDiag 的更多用法,请参见 API 说明 部分。

设置设备唯一 ID

在 Android 日志 SDK 中,userId 是用于捞取日志和染色的标识(由于历史原因命名为 userId),建议使用设备唯一 ID,可在初始化后同步调用并传入,也可在 App 获取到唯一标识后异步调用传入。
TDDiag.setUserId("uid");


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈