本文介绍了 weex 环境中云前端监控的接入配置。

导入 npm 包

在 weex 环境中,使用专门的 WeexLogger 模块来上报日志,接入时需要在项目中导入 alife-logger npm 包。

npm install alife-logger --save

初始化

在 weex 应用入口调用 singleton(props) 静态方法获取实例,需要在传入的 props 中设定相关配置,详情参见通用 API

// in app.js
import WeexLogger from 'alife-logger/weex';

const wxLogger = WeexLogger.singleton({
    pid: 'your-project-id',
    uid: 'zhangsan', // Login uid, for UV report
    page: 'Lazada | Home', // Initial page name, if passed, SDK will send a PV log after Initialization completed
    imgUrl: 'https://arms-retcode.aliyuncs.com/r.png?' // 设定日志上传地址,新加坡部署可选`https://arms-retcode-sg.aliyuncs.com/r.png?`
});

上报

通过实例调用相应的上报方法进行上报。

// in some biz module
import WeexLogger from 'alife-logger/weex';

wxLogger.api('/search.do', true, 233, 'SUCCESS');

通用 API

@static singleton() 获取单例对象

静态方法,返回一个单例对象。props 用法如下(只在第一次调用时生效)。

调用参数说明:WeexLogger.singleton(props)

属性 类型 描述 是否必须 默认值
pid String 站点 ID -
page String 初始化的 Page Name -
uid String 用户 ID -
imgUrl String 日志上传地址,以“?”结尾 -

此方法可用于在应用入口初始化 SDK,示例参见初始化

setPage() 设置当前页面的 Page Name

设置 Page Name,并且上报一次 PV 日志(默认)。

调用参数说明:

const wxLogger = WeexLogger.singleton();
// ...
wxLogger.setPage(nextPage);
			
参数 类型 描述 是否必须 默认值
nextPage String Page Name -

setConfig() 修改配置项

用于在 SDK 初始化完成后修改部分配置项,具体配置同 singleton() 方法。

调用参数说明:

const wxLogger = WeexLogger.singleton();
// ...
wxLogger.setConfig(next);
			
参数 类型 描述 是否必须 默认值
next Object 需要修改的配置项以及值 -

日志上报 API

请参见 API 使用指南的“日志上报接口”。