返回插件列表

MLogCollection

APP日志采集插件:采集崩溃日志、天眼普通日志。

注意事项

  1. iOS项目已经添加mbugly或mdebugging插件重要提示:因这两个插件都含有崩溃日志收集,若已添加mbugly插件请更新至1.0.9,若已添加mdebugging插件请更新至1.0.9,否则可能导致无法采集崩溃日志

  2. 因要上传到阿里云oss服务器,必须依赖阿里云oss上传插件

  3. 崩溃日志上传规则

  4. 天眼普通日志上传规则

  5. 天眼属性文档

API

目录

  1. 普通日志写入文件

  2. 设置天眼配置参数

  3. 获取APP基础信息

  4. 设置日志采集级别

  5. 设置普通日志文件大小

  6. 设置压缩包文件压缩个数

普通日志写入文件

MLogCollection.writeToFile(log,success,error);

调用writeToFile方法写入普通日志文件时,会一直把日志信息追加进同一个文件里面;

若文件已经达到maxSize,则会新增一个日志文件,后续日志将追加进此文件内;

maxSize默认初始值为200kb,若要修改maxSize的值,请调用setLogMaxSize方法。

参数 类型 必填 作用
log string 要写入文件的日志
success function 成功回调
error function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}

设置天眼配置参数

MLogCollection.setConfigParams(config,success,error);
参数 类型 必填 作用
config json 配置参数,追加进崩溃日志里面。
success function 成功回调
error function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}

注意:

  1. config格式为{"p":"fast", "a":"analysis", "...":"..."}
  2. 其中p对应producta对应apppa用于获取oss上传文件授权Token。如果p和a没有赋过值,会导致无法获取Token,日志无法上传。
  3. pa保存逻辑:如果config中含pa,那么将会覆盖之前的pa,如果不含,则使用之前存储的pa
  4. ...表示支持任意扩展keyvalue
  5. config内容将会追加入crash_log

获取APP基础信息

MLogCollection.getBasicInformation(success);
参数 类型 必填 作用
success(result) function 成功回调,result为基础信息,是一个json字符串,字段详情请参考天眼属性文档

设置日志采集级别

MLogCollection.setLogCollectionLevel(level,success,error);
参数 类型 必填 作用
level string 设置采集级别:
all:允许崩溃日志采集上传,允许天眼普通日志写入和上传;
event:只允许天眼普通日志写入和上传;
crash:只允许崩溃日志采集和上传;
none:禁止所有日志采集和上传。
success function 成功回调
error function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}

设置普通日志文件大小

调用writeToFile方法写入普通日志文件时,会一直把日志信息追加进同一个文件里面;

若文件已经达到maxSize,则会新增一个日志文件,后续日志将追加进此文件内;

如果不调用此方法,插件默认初始值为200kb。

MLogCollection.setLogMaxSize(maxSize,success,error);
参数 类型 必填 作用
maxSize int 普通日志文件size最大值,单位kb
success function 成功回调
error function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}

设置压缩包文件压缩个数

上传过程中,若文件个数较多,只压缩规定内的数目文件成zip上传到oss服务器,其他的等待下次上传时机;

如果不调用此方法,插件默认初始值为10。

MLogCollection.setCompressionNumber(number,success,error);
参数 类型 必填 作用
number int 文件压缩个数
success function 成功回调
error function 错误回调,err为详细错误信息,是一个json对象,例如:{"code":-1,"message":"出错啦"}

崩溃日志上传规则

1、崩溃日志采集和上传功能未被禁用;

2、检测到崩溃日志,判断当前网络为3g/4g/wifi时不压缩立即上传;

3、上传成功,删除本地文件;上传失败,等待下次上传时机;

4、前后台切换时,检测到有未上传的崩溃日志文件,判断当前网络为3g/4g/wifi时不压缩批量上传。

天眼普通日志上传规则

1、天眼普通日志写入和上传功能未被禁用;

2、前后台切换时,检测普通日志文件,判断当前网络为3g/4g/wifi时根据压缩文件个数,将所有非zip格式日志文件按压缩数目进行批量压缩,不足压缩个数则按当前个数压缩,同时删除源文件,上传压缩文件;

3、上传成功,删除压缩文件;上传失败,保留压缩文件,等待下一次上传时机。