DataFlux Miniapp Logs SDK

简介

小程序主动发送不同等级的日志数据(对应的source:browser_log
指标类型日志数据)到DataFlux。

功能简介

- 自定义日志数据采集，通过 sdk 接入客户端应用中，针对不同场景采集不同日志数据。
- 可以自动收集应用端的错误信息（包括网络错误，console 错误，以及 js 错误）上报到 DataFlux。
- 自定义错误等级（debug,critical,error,info,warn）,自定义 Logger 对象，以及自定义 log 字段
- 可以自动收集RUM相关数据，关联 RUM 业务场景

开始使用

$3

datakit 通过datakit日志采集 API 发送日志数据到 DataFlux 平台

引入 SDK 可通过NPM,CDN的方式引入 SDK 到应用中，初始化后，可以存放到全局变量中，方便其他页面引用

支持的浏览器 支持微信，百度，支付宝，头条大部分小程序端

$3

``javascript
//#ifndef H5 || APP-PLUS || APP-NVUE || APP-PLUS-NVUE
const { datafluxRum } = require('@cloudcare/dataflux-rum-miniapp-logs')
// 初始化 Rum
datafluxRum.init({
datakitOrigin: ''
service: 'minapp',
})
//#endif
`

$3

`javascript
//#ifndef H5 || APP-PLUS || APP-NVUE || APP-PLUS-NVUE
const { datafluxRum } = require('@cloudcare/dataflux-rum-miniapp-logs')
// 初始化 Rum
datafluxRum.init({
datakitOrigin: ''
service: 'miniapp',
})
//#endif
`

配置

$3

| 参数 | 类型 | 是否必须 | 默认值 | 描述 |
| --------------------- | ------- | -------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| datakitOrigin | String | 是 | | datakit 数据上报 Origin 注释: 协议（包括：//），域名（或IP地址）[和端口号] 例如：https://www.datakit.com, http://100.20.34.3:8088 |
| site | String | 是（公网dataway上报方式 必填） | | （SDK 版本要求 >= 1.0.4 ）公网 DataWay 对应站点的域名 注释: 协议（包括：//），域名（或IP地址）[和端口号] 例如：https://www.datakit.com, http://100.20.34.3:8088 |
| clientToken | String | 是 （公网dataway 必填） | | （SDK 版本要求 >= 1.0.4 ）公网 DataWay 上报所需的客户端 token，在观测云控制台创建应用时生成 |
| service | String | 否 | browser | 日志 service 名称 |
| env | String | 否 | | web 应用当前环境， 如 prod：线上环境；gray：灰度环境；pre：预发布环境 common：日常环境；local：本地环境； |
| version | String | 否 | | web 应用的版本号 |
| sampleRate | Number | 否 | 100 | 指标数据收集百分比: 100表示全收集，0表示不收集 |
| forwardErrorsToLogs | Boolean | 否 | true | 设置为false 表示停止采集 console.error、 js、以及网络错误上报到 DataFlux 日志数据中 |

使用

SDK 在应用中初始化后，通过暴露的 SDK API 可以自定义配置日志数据

`js
logger.debug | info | warn | error | critical (message: string, messageContext = Context)
`

$3

`js
import { datafluxLogs } from '@cloudcare/dataflux-rum-miniapp-logs'

datafluxLogs.logger.info('Button clicked', { name: 'buttonName', id: 123 })
`

返回数据结构

`JSON
{
"service": "miniapp",
"session": {
"id": "c549c2b8-4955-4f74-b7f8-a5f42fc6e79b"
},
"type": "logger",
"_dd": {
"sdk_name": "miniapp LOG SDK",
"sdk_version": "1.0.0",
"env": "",
"version": ""
},
"device": {
"platform_version": "8.0.5",
"model": "iPhone 6/7/8 Plus",
"app_framework_version":"2.23.3",
"os": "OS",
"os_version": "10.14.6",
"os_version_major": "10",
"screen_size": "414*736",
"network_type": "3g",
"divice": "devtools"
},
"user": {},
"date": 1621321916756,
"view": {
"referrer": "",
"name": "pages/index/index",
"id": "5dce64f4-8d6d-411a-af84-c41653ccd94a"
},
"application": {
"id": "app_idxxxxxx"
},
"message": "XHR error get http://testing-ft2x-api.cloudcare.cn/api/v1/workspace/xxx",
"status": "error",
"error": {
"source": "network",
"stack": "Failed to load"
},
"resource": {
"method": "get",
"status": 0,
"status_group": 0,
"url": "http://testing-ft2x-api.cloudcare.cn/api/v1/workspace/xxx",
"url_host": "testing-ft2x-api.cloudcare.cn",
"url_path": "/api/v1/workspace/xxx",
"url_path_group": "/api/?/workspace/xxx"
}
}
`

Status 参数

初始化 SDk 后，可以使用提供log API,定义不同类型的状态

`js
log (message: string, messageContext: Context, status? = 'debug' | 'info' | 'warning' | 'error' | 'critical')
`

$3

`js
import { datafluxLogs } from '@cloudcare/dataflux-rum-miniapp-logs'

datafluxLogs.logger.log(,,);

`

参数说明

| 参数 | 描述 |
| ------------------- | ------------------------------------------------------------------- |
| | Dataflux 日志中的 message 字段 |
| | 描述 message 的额外数据，是一个 json 对象 |
| | 日志的等级，可选值：debug, info, warning, error, critical` |