数据上报验证

最近更新时间:2025-12-12 10:52:41

我的收藏
SDK 支持业务主动调用上报接口,上传自定义日志、文件等信息。该功能可用于用户反馈、异常发生等场景及时上报本地日志信息,帮助保留问题现场。

下发指令

平台提供了日志捞取指令的下发功能,用户可以在平台管理端的 终端性能监控 Pro > 日志 > 日志查询 页面进行指令的下发和上报结果查询。
通过 新建查询 入口,新建一个日志捞取命令:

此处需要填入一个有效的设备 ID 值,该值便是 SDK 初始化 时,由 TDLogSDKDataSource 中的 - (NSString *)guidForTDLog; 提供的值。
TDOS_DiagnoseSDK 会默认在启动/进入前台等时机时,以一定的时间间隔主动检查有无日志捞取命令。对于有日志命令的设备,会进行对应日志的上报任务。

主动上报

由于主动上报是程序自动触发,其频率与时机存在不可控性。为了保障上报安全,避免 App 异常情况下高频上报,导致浪费流量等问题,TDOS_Diagnose SDK 对主动上报提供了如下4种安全机制:
大小限制机制:限制压缩前的总文件大小(默认500M),超过上限则只保留修改时间较新的部分文件。
频率限制机制:支持设置主动上传的频率,如10分钟内3次(SDK 默认不开启)。设置接口参见 TDLogSDKConfig。
流量限制机制:支持设置每24小时的总上报流量与 XG 流量(SDK 默认不开启),超过额度将禁止上报。设置接口参见 TDLogSDKConfig。
错误熔断机制:连续上传失败10次后,将停用自动上报6h。(此机制为 SDK 内部安全兜底机制,暂不支持调整)。
TDOS_Diagnose SDK 支持 App 主动调用上报接口,上传自定义日志、文件等信息。主动上报的日志可以在 终端性能监控 Pro > 日志 > 日志查询主动上报 Tab 下查询到。
该功能可用于用户反馈、异常发生等场景及时上报本地日志信息,帮助保留问题现场。接口说明如下:
/// 主动上报日志
/// @param files 日志文件列表
/// @param tag 标签,必填,最大长度64bytes
/// @param summary 摘要信息(支持搜索),最大长度256bytes
/// @param extendInfoDict 扩展信息,最大长度1K
/// @param completionBlock 上传结果回调
- (void)uploadFiles:(nonnull NSArray <NSString *> *)files
withTag:(NSString *)tag
summary:(nullable NSString *)summary
andExtendInfo:(nullable NSDictionary *)extendInfoDict
completion:(void (^)(BOOL result, NSString *_Nullable errMsg))completionBlock;
成功上报后,在 终端性能监控 Pro > 日志 > 日志查询主动上报页面即可查看上报记录和内容。

注意:
请合理指定上报内容或时间范围,避免主动上报日志过大或调用过于频繁。