观测云用户体验中的基础功能(自定义tag、错误、事件)
存在一些特定场景,需要通过设置不同类型的标识去定位分析一些数据,所以针对这些情况,RUM SDK 提供了一些特定的API 方便用户在自己的应用系统中,加入自己特定的逻辑:
- 自定义标识用户(ID、name、email)
- 自定义添加额外的数据 TAG
- 自定义添加 Action
- 自定义添加 Error
Rum自定义用户
自定义标识用户
SDK 默认情况下,自动会给用户生成一个唯一标识ID。这个ID不带任何标识属性,只能区别出不同用户属性。 为此我们提供了额外的API去给当前用户添加不同的标识属性。
属性 | 类型 | 描述 |
user.id | string | 用户ID |
以下属性是可选的,但建议至少提供其中一个。
添加用户标识
window.DATAFLUX_RUM && window.DATAFLUX_RUM.setUser({
id: '1234',
})
自定义添加额外的数据 TAG
初始化 RUM 后,使用addRumGlobalContext(key:string,value:any)
API 向从应用程序收集的所有 RUM 事件添加额外的TAG。
添加TAG
// Code example
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addRumGlobalContext('isvip', 'xxxx');
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addRumGlobalContext('activity', {
hasPaid: true,
amount: 23.42
});
替换TAG
// Code example
window.DATAFLUX_RUM &&
DATAFLUX_RUM.setRumGlobalContext({
codeVersion: 34,
});
自定义添加 Action
初始化 RUM 后,使用addAction('<NAME>','<JSON_OBJECT>')
API,可以自定义添加采集之外的action 指标数据。
// Code example
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addAction('cart', {
amount: 42,
nb_items: 2,
items: ['socks', 't-shirt'],
});
自定义添加 Error
初始化 RUM 后,使用addError('<NAME>','<JSON_OBJECT>')
API,可以自定义添加采集之外的 error 指标数据。
添加Error
// Send a custom error with context
const error = new Error('Something wrong occurred.');
window.DATAFLUX_RUM && DATAFLUX_RUM.addError(error, {
pageStatus: 'beta',
});
标签:&&,DATAFLUX,自定义,RUM,必不可少,观测,window,添加,监控
From: https://blog.51cto.com/u_12003135/9443794