bonree-log-jsagent v1.0.3

bonree-log-jsagent

bonreelog用于采集browser中的日志数据，bonreelog可自动采集上报网络错误、js错误、控制台console输出的日志数据及自定义的日志数据。

如何使用

• 安装

  npm install bonree-log-jsagent --save

• 导出

  import { BRLogStart } from 'bonree-log-jsagent'

• 初始配置

  BRLogStart({
      appID:'b5a8ce5e-a3a8-11ed-b908-0e832fe4bb04',
      uploadAddrHttp:'http://oneupload.bonree.com/logs/otel/v1/logs',
      uploadAddrHttps:'https://oneupload.bonree.com/logs/otel/v1/logs',
  })

• 代码中使用

  window.BRLog&&window.BRLog.logger.info('this is a log from web')

配置

注：如果页面中使用了bonree的js探针，且无法保证js探针在log之前初始化，请勿配置netCollector和errorCollector，否则将导致error或network数据缺失

日志级别

用法

自定义日志

bonreeLog初始化成功后，使用API直接向平台发送自定义日志，支持传入message自定义日志数据，支持传入Error对象

logger.debug | info | warn | error (message: string,error?: Error)

用例

try {
  ...
  throw new Error('Wrong behavior')
  ...
} catch (error) {
  window.BRLog&&window.BRLog.logger.error('Error occurred', error)
}

完全自定义日志

bonreeLog初始化成功后，使用API直接向平台发送自定义日志，支持自定义日志级别（debug、info、warn、error），支持传入message自定义日志数据，支持传入Error对象，支持自定义属性attribute，attribute仅支持传入{key:value,...}格式对象

logger.log (level:'debug'|'info'|'warn'|'error', message: string ,error?: Error ,attribute?:object)

用例

try {
  ...
  throw new Error('Minor misbehavior')
  ...
} catch (error) {
  window.BRLog&&window.BRLog.logger.log('info', 'Minor misbehavior occurs',error,{JSON:'JSON parsing failed'})
}

高级用法

过滤日志

bonreeLog初始化成功后，使用 API 设置记录的最低日志级别，低于该日志级别的日志数据将被过滤

setLevel (level: 'debug' | 'info' | 'warn' | 'error')

用例

 window.BRLog&&window.BRLog.logger.setLevel('info')

设置日志前缀

bonreeLog初始化成功后，使用 API 设置日志前缀名

setPrefix('bonree')

用例

window.BRLog&&window.BRLog.logger.setPrefix('bonree')

添加属性

bonreeLog初始化成功后，使用 API 记录添加全局日志属性

addAttribute(key:string,value:string)

用例

 window.BRLog&&window.BRLog.addAttribute('original','logger')

移除属性

bonreeLog初始化成功后，使用 API 记录移除全局日志属性

removeAttribute(key:string)

用例

window.BRLog&&window.BRLog.removeAttribute('original')