全部产品

上报日志

更新时间:2019-09-09 15:12:45

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

  • 自动上报:满足一定条件后自动上报。
  • 日志开关上报:在自动上报的基础上,通过服务端下发的开关值,修改自动上报触发的条件。
  • 手动上报:调用上报日志接口强制上报。

自动上报

触发日志自动上报的条件如下:

  • 程序每次冷启动都会触发检查日志上报的逻辑。
  • 程序进入后台会立即触发上报。
  • 写日志时,某种类型的日志默认到达 40 条就触发上报。
  • 为保证闪退日志能够及时上报,每次发生闪退后,会在应用下次启动时触发上报。

日志开关上报

在上述默认触发日志上报的条件下,您还可以通过控制台 移动分析 > 日志管理 > 开关配置 动态控制日志上报的时机。

  • 设置日志开关配置的地址:

    logConfigServerURL

  • 在控制台动态控制日志上报的时机:

    logConfigList

    logConfig

    各参数的含义如下:

    • 上报开关:只有打开此开关,此日志和开关配置才生效。
    • 网络:选择 全网环境仅在 WiFi 环境下上报。
    • 业务码:与客户端埋点时的 bizType 对应。常见的业务码请参见 查看本地日志
    • 日志上报条数:本地文件中此 bizType 类型的日志到达条数触发上传(即修改上述 40 条的阈值)。
    • 日志上报比率:按用户维度设置日志上报的比率,采用千分制,如 1000 表示全部用户都上报。
    • 最低上报等级:每条日志写入时都会设置一个等级,小于等于此设置值的日志上报。如设置最低上报等级为 2 时,则等级为 1 和 2 的日志会上报,而等级为 3 的日志不上报。
      更多信息,请参见 日志开关配置

手动上报

若业务需要保证某些日志实时上报,您可以调用以下接口强制上报日志:

  1. [APRemoteLogger upload];