写入客户端本地文件中的日志,会通过以下三种方式同步到日志服务器。
如需停止日志上报,可通过关闭 iOS 客户端埋点开关来实现。具体参见 停止日志上报。
自动上报
触发日志自动上报的条件如下:
程序每次冷启动都会触发检查日志上报的逻辑。
程序进入后台会立即触发上报。
写日志时,某种类型的日志默认达到 40 条就触发上报。
为保证闪退日志能够及时上报,每次发生闪退后,会在应用下次启动时触发上报。
日志开关上报
在上述默认触发日志上报的条件下,您还可以通过控制台 移动分析 > 日志管理 > 配置上传开关 > 埋点配置 对日志上报进行动态控制。
在控制台动态控制日志上报,各参数的含义如下:
上报开关:只有打开此开关,此日志和开关配置才生效。
网络:选择 全网环境 或 仅在 WiFi 环境下上报。
业务码:与客户端埋点时的 bizType 对应。常见的业务码请参见 查看本地日志。
最低上报等级:每条日志写入时都会设置一个等级,小于等于此设置值的日志会被上报。如设置最低上报等级为 2 时,则等级为 1 和 2 的日志会被上报,而等级为 3 的日志不会被上报。
日志上报条数:本地文件中此 bizType 类型的日志达到条数触发上传(即修改上述 40 条的阈值)。
日志上报比率:按用户维度设置日志上报的比率,采用千分制,如 1000 表示全部用户的日志都上报。更多信息,请参见 配置日志上报开关。
手动上报
若业务需要保证某些日志实时上报,您可以调用以下接口强制上报日志:
[MPRemoteLoggingInterface upload];
停止日志上报
关闭 iOS 客户端埋点开关来停止日志上报。
重要
该方法仅适用于 10.1.68.42 及以上基线版本。
停用埋点的方法如下:
#import <MPMasAdapter/MPAnalysisHelper.h>
[MPAnalysisHelper enableRemoteLog:NO];