文档

上报日志

更新时间:

写入客户端本地文件中的日志,会通过以下三种方式同步到日志服务器。

  • 自动上报:满足一定条件后自动上报。

  • 日志开关上报:在自动上报的基础上,通过服务端下发的开关值,修改自动上报触发的条件。

  • 手动上报:调用上报日志接口强制上报。

如需停止日志上报,可通过关闭 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];