跳转至

小程序应用数据采集

应用数据采集到观测云后，可以通过观测云控制台进行自定义配置场景和配置异常检测事件。

数据类型

观测云的用户访问监测包括六种数据类型：

类型 描述
session 用户会话信息记录，当前会话中，将会基于会话维度用户页面、资源、操作、错误、长任务相关访问数据。
view 用户访问页面时，都会生成一个页面查看记录。当用户停留在同一页面上时，资源，长任务，错误和操作记录将通过 view_id 属性链接到相关的 RUM 视图。
resource 用户访问页面时，加载的资源信息记录。
error 用户访问监测采集器收集浏览器上的所有前端错误。
long_task 对于浏览器中的任何阻塞主线程超过 50ms 的任务，都会生成一条长任务记录。
action 跟踪用户页面浏览过程中所有的用户交互记录。

全局属性

用户访问监测的场景构建和事件告警都可以通过下面的全局属性进行查询。

SDK 属性

字段 类型 描述
sdk_name string 采集器名称，固定名称：
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk
sdk_version string 采集器版本信息

应用属性

字段 类型 描述
app_id string 必填，用户访问应用唯一 ID 标识，在观测云控制台上面创建监控时自动生成。
env string 必填，环境字段。属性值：prod/gray/pre/common/local。其中：
prod：线上环境
gray：灰度环境
pre：预发布环境
common：日常环境
local：本地环境
version string 必填，版本号。
app_launch_query string 启动小程序的 query 参数。
app_launch_referrer_info string 来源信息。从另一个小程序、公众号或 App 进入小程序时返回。

更多详情，可参考 相关字段说明。

用户 & 会话属性

字段 类型 描述
userid string 未登录用户使用 cookie 作为 userid，登录用户使用应用后台生成的用户 id。
session_id string 会话 id。
session_type string 会话类型。参考值：user & synthetics
user：RUM 功能产生的数据；
synthetics：headless 拨测产生的数据。
is_signin boolean 是否是注册用户，属性值：True / False。

设备 & 分辨率属性

字段 类型 描述
device string 移动设备厂商
model string 移动设备型号
device_uuid string 移动设备唯一 ID
os string 操作系统信息
os_version string 操作系统版本
os_version_major string 操作系统主要版本
screen_size string 屏幕分辨率

地理 & 网络属性

字段 类型 描述
ip string 用户访问IP地址
isp string 运营商
network_type string 网络连接类型，属性值参考：
wifi & 2g & 3g & 4g & 5g & unknown（未知网络）& unreachable（网络不可用）
country string 国家
country_iso_code string 国家 iso_code
province string 省
city string 城市

平台 & 库版本属性

字段 类型 描述
platform string 小程序所在的app平台，如微信小程序的 platform 就是 wechat
platform_version string 小程序所在的 app 平台的版本
app_framework_version string 小程序基础版本库

自定义属性

除全局属性以外，还可以通过自定义属性（SDK 支持用户打自定义的 tag 数据）构建场景和配置事件告警。自定义属性是非全局属性，通过自定义属性，可以跟踪用户访问应用的整个过程，定位和发现用户受影响的访问情况，监控用户访问性能。

其他数据类型属性

Session

属性

字段 类型 描述
session_id string 会话 id
session_type string 会话类型。参考值：user & test
user：RUM 功能产生的数据；
test：headless 拨测产生的数据。
session_referrer string 会话来源；一般是记录来源的页面地址
session_first_view_id string 当前会话的第一个页面的 view_id
session_first_view_name string 当前会话的第一个页面的名称
session_last_view_id string 当前会话的最后一个访问页面的 view_id
session_last_view_name string 当前会话的最后一个页面的名称

指标

字段 类型 描述
time_spent number(ns) 当前会话持续时长
session_view_count number 当前会话关联 view_id 个数
session_error_count number 当前会话产生错误个数
session_resource_count number 当前会话加载资源个数
session_action_count number 当前会话用户操作次数
session_long_task_count number 当前会话产生长任务次数

View

属性

字段 类型 描述
view_id string 每次访问页面时产生的唯一 ID
view_referrer string 页面来源
view_name string 页面 URL
performance_supported boolean 当前平台 Performance Observer 是否订阅成功
first_render_supported boolean 当前平台是否存在 SDK 可用的首次渲染信号
view_start_reason string View 创建原因：page_load、page_show 或 session_renewal

指标

字段 类型 描述
loading_time number（ns） 页面 navigation 与生命周期观测到的最大加载耗时
page_ready_time number（ns） View 开始到 onReady 的耗时；page_fmp 为兼容字段
first_render_time number（ns） 微信 firstRender.duration；抖音为 first-paint - navigationStart；first_paint_time 为兼容字段
page_fp number（ns） FP 相对当前页面 navigationStart 的耗时
page_fcp number（ns） FCP 相对当前页面 navigationStart 的耗时
page_lcp number（ns） 当前页面最近一次 LCP 相对 navigationStart 的耗时
first_render_data_transfer_time number（ns） 首次渲染初始化数据传输耗时
first_render_wait_time number（ns） 数据接收完成到视图层开始渲染的等待耗时
first_render_view_layer_time number（ns） 视图层首次渲染耗时
time_spent number（ns） 页面停留时间
onload_to_onshow number（ns） 页面 onload 时间到 onshow 耗时
onshow_to_onready number（ns） 页面 onshow 时间到 onready 耗时
ready_reached boolean 当前页面生命周期是否到达 onReady
first_render_reached boolean 当前页面是否已收到平台首次渲染信号
ended_before_ready boolean page_load View 结束时是否仍未到达 onReady
ended_before_render boolean 支持首次渲染信号时，page_load View 是否在首次渲染前结束
view_end_reason string View 结束原因：onHide、onUnload 或 session_renewal
view_is_active boolean View 是否仍处于活动状态
view_setdata_duration number（ns） 当前 View 所有有效 setData 更新的累计耗时
view_setdata_max_duration number（ns） 单次 setData 更新最大耗时
view_setdata_pending_duration number（ns） setData 从进入队列到开始更新的累计等待耗时
view_setdata_update_duration number（ns） setData 从开始更新到结束的累计执行耗时
view_setdata_merged_count number 被平台合并处理的 setData 更新次数
is_active boolean 判断用户是否还在活跃状态，参考值：true & false

性能字段的平台口径、白屏候选统计和已知边界，参见性能问题分析。

统计指标

字段 类型 描述
view_error_count number 每次页面加载时发生的错误次数
view_resource_count number 每次页面加载时请求的资源个数
view_long_task_count number 每次页面加载时产生的长任务个数
view_action_count number 页面查看过程中操作的次数
view_setdata_count number 页面 set_data 调用次数
view_apdex_level number 页面首次渲染

Resource

View 属性

字段 类型 描述
view_id string 每次访问页面时产生的唯一 ID
view_referrer string 页面来源
view_name string 页面 URL

Resource 属性

字段 类型 描述
resource_url string 资源 URL
resource_url_host string 资源 URL 域名部分
resource_url_path string 资源 URL path 部分
resource_url_query string 资源 URL query 部分
resource_url_path_group string 资源 URL path 分组
resource_type string 资源的类别
resource_method string 资源请求方式
resource_status string 资源请求返回的状态值
resource_status_group string 资源请求返回的状态分组值

指标

字段 类型 描述
resource_size number 资源大小，默认单位：byte
resource_dns number（ns） 资源加载 DNS 解析时间
计算方式：domainLookupEnd - domainLookupStart
resource_tcp number（ns） 资源加载 TCP 连接时间
计算方式：connectEnd - connectStart
resource_ssl number（ns） 资源加载 SSL 连接时间
计算方式：connectEnd - secureConnectStart
resource_ttfb number（ns） 资源加载请求响应时间
计算方式：responseStart - requestStart
resource_trans number（ns） 资源加载内容传输时间
计算方式：responseEnd - responseStart
resource_first_byte number（ns） 资源加载首包时间
计算方式：responseStart - domainLookupStart
duration number（ns） 资源加载时间
计算方式：duration(responseEnd-startTime)

Error

View 属性

字段 类型 描述
view_id string 每次访问页面时产生的唯一 ID
is_active boolean 判断用户是否还在活跃状态，参考值: true & false
view_referrer string 页面来源
view_name string 页面 URL

Error 属性

字段 类型 描述
error_source string 错误来源，参考值：console & network & source & custom
error_type string 错误类型，参考链接：error type
resource_status string 资源请求返回的状态值
resource_url string 资源 URL
resource_url_host string 资源 URL 域名部分
resource_url_path string 资源 URL path 部分
resource_url_path_group string 资源 URL path 分组
resource_method string 资源请求方式

指标

字段 类型 描述
error_message string 错误信息
error_stack string 错误堆栈

Long Task

View 属性

字段 类型 描述
view_id string 每次访问页面时产生的唯一 ID
is_active boolean 判断用户是否还在活跃状态，参考值: true & false
view_referrer string 页面来源
view_name string 页面 URL

指标

字段 类型 描述
duration number（ns） 页面加载时产生的长任务花费时间

Action

View 属性

字段 类型 描述
view_id string 每次访问页面时产生的唯一 ID
is_active boolean 判断用户是否还在活跃状态，参考值: true & false
view_referrer string 页面来源
view_name string 页面 URL

Action 属性

字段 类型 描述
action_id string 用户页面操作时产生的唯一 ID
action_name string 操作名称
action_type string 操作类型：
启动尝试 - launch_attempt（不加 view 相关信息）
启动 - launch（不加 view 相关信息）
小程序包下载 - package_download（不加 view 相关信息）
脚本注入 - script_insert（不加 view 相关信息）
点击 - click 等

指标

字段 类型 描述
duration number（ns） 页面操作花费时间
app_launch_attempt boolean action_type=launch_attempt 时为 true；该事件不写入 duration

统计指标

字段 类型 描述
action_long_task_count number 操作关联长任务次数
action_resource_count number 操作关联资源请求次数
action_error_count number 操作关联的错误次数

文档评价

文档内容是否对您有帮助？