以 npm 方式安装探针

以 npm 方式安装探针
镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站

一、安装

在 npm 仓库中安装 alife-logger

npm install alife-logger --save

二、使用

1. 初始化

SDK 以 BrowerLogger.singleton 方式初始化。

const BrowerLogger = require('alife-logger');
// BrowserLogger.singleton(conf) conf传入config配置
const __bl = BrowerLogger.singleton({
    pid: 'your-project-id',
    imgUrl: 'https://arms-retcode.aliyuncs.com/r.png?', // 设定日志上传地址,新加坡部署可选`https://arms-retcode-sg.aliyuncs.com/r.png?`
    // 其他config配置
});

使用 npm 方式接入 ARMS 前端监控时,Web 端 SDK 会自动生成 UID 来统计 UV 等信息。自动生成的 UID 可以用来区分用户的标识,但不具有业务属性,若您想自定义 UID,请在上述代码中加入以下内容:

uid: 'xxx', // 该值用于区分用户的标识,根据业务设置

例如:

const BrowserLogger = require('alife-logger');
// BrowserLogger.singleton(conf) conf传入config配置
const __bl = BrowserLogger.singleton({
    pid: 'your-project-id',
    uid: 'xxx', // 该值用于区分用户的标识,根据业务设置
    imgUrl: 'https://arms-retcode.aliyuncs.com/r.png?', // 设定日志上传地址,新加坡部署可选`https://arms-retcode-sg.aliyuncs.com/r.png?`
    // 其他config配置
});

2. API 说明

@static singleton() 获取单例对象
说明 该方法只适用于 npm 引入。
调用参数说明:BrowerLogger.singleton(config,prePipe)
静态方法,返回一个单例对象,传入的 config、prePipe 只在第一次调用时生效,此后调用只返回已经生成的实例。

参数 类型 描述 是否必须 默认值
config Object 站点配置,其他配置查看 #config 配置项 -
prePipe Array 预上报内容 -

此方法可以用于在应用入口初始化 SDK,也可以在每次调用时获取实例。

3. 其他上报 API

通过 BrowerLogger.singleton 获取实例。

const __bl = BrowerLogger.singleton();

关于 __bl 的其他 API 使用方式,请参考 API 使用指南

4. Config 配置

Config 配置与 CDN 引入配置相同。请参考 前端监控 SDK 配置项

5. 预上报

场景:在调用 BrowserLogger.singleton() 之前执行的部分逻辑需要上报一些数据。

const BrowerLogger = require('alife-logger');
// 与 CDN 的 Pipe 结构一致
const pipe = [
    // 将当前页面的 HTML 也作为一个 API 上报
    ['api', '/index.html', true, performance.now, 'SUCCESS'],
    // SDK 初始化完成后即开启 SPA 自动解析
    ['setConfig', {enableSPA: true}]
];
const __bl = BrowserLogger.singleton({pid:'站点唯一ID'},pipe);

阿里巴巴开源镜像站 提供全面,高效和稳定的系统镜像、应用软件下载、域名解析和时间同步服务。”

上一篇:Maven - 解决Maven下载依赖包速度慢问题


下一篇:阿里下一代数据库技术:把数据库装入容器不再是神话