快速入门
下面用一个 Web 应用完成「创建应用 → 安装脚本 → 看到会话 → 配置一条体验策略」。
一、前置条件
- 当前账号具备 RUM 的应用和接入权限。
- 有一个可以修改前端构建或页面模板的 Web 应用。
- 用户浏览器能够访问平台提供的采集地址。页面所在域名需要在应用里放行。
二、创建应用并安装脚本
- 进入 「集成」-「应用」,新建应用并填写应用名称。
- 打开 「集成」-「接入」,进入该应用的接入步骤。
- 按技术栈复制脚本,可选 npm、React、CDN 或通用片段。
- 把脚本放到应用入口。CDN 或通用片段通常放在页面加载早期。npm 或 React 方式按页面给出的依赖和初始化方式安装。
- 配置允许上报的来源域名,避免非本站页面把数据写入这个应用。
- 用真实浏览器打开页面并完成一次点击或跳转。
界面指引:
界面截图待补充。
- 操作关注点:接入列表里,最近接收和写入都落在 15 分钟内时,状态为「已接入」。还没有新鲜数据时为「未接入」。应用停用后为「已禁用」。
三、确认会话和页面指标
- 打开 「体验」-「会话」,选择刚接入的应用和时间范围。
- 确认列表中出现会话。可以按「影响力」「开始时间」「错误数」或「时长」排序,也可以按会话标识搜索。
- 打开一条会话,查看页面、设备和浏览器信息。需要回看操作过程时,进入该会话的回放。
- 打开 「体验」-「视图与性能」,查看页面的 LCP、INP 等指标和分布。没有样本时指标显示为空,不代表页面一定健康。
四、查看错误和版本
- 打开 「质量」-「错误追踪」,按应用查看聚合后的错误,进入详情看证据栈。
- 若错误栈是压缩后的代码,打开 「质量」-「部署追踪」,切换到 SourceMap 管理。
- 选择应用,填写版本、部署产物路径并上传 SourceMap 文件。
- 如需给流水线使用,轮换 CI Token。Token 只显示一次,关闭前复制备用。
- 选定单个应用后,可以标记体验基线,再对比后续版本的变化。全部应用汇总时不能标记基线。
五、配置一条体验策略
- 打开 「事件」-「策略」,新建策略并选择应用。
- 选择指标。可选错误率、LCP P75、INP P75、CLS P75、FCP P75、TTFB P75、会话数。
- 选择比较方式,并填写警告和严重阈值。错误率按百分比理解,CLS 按分数,时延类指标按毫秒。页面会给出常用默认值,会话数需要自行填写。
- 选择严重级别:「提示」「警告」或「严重」。保存后可在列表中启用或停用。
- 到 「事件」-「告警」 查看策略触发后的告警。
六、可选:转化漏斗和合规删除
- 打开 「体验」-「转化漏斗」,新建漏斗。名称必填,路由步骤为 2 到 8 个,用英文逗号分隔,例如
/,/checkout,/success。 - 选择应用后保存。漏斗按当前筛选范围计算到达人数和转化率。
- 需要删除某个用户的体验数据时,打开 「数据治理」-「合规删除」,选择应用并填写用户标识,提交后在任务列表核对状态。
七、结果验证与闭环
- 接入页状态变为「已接入」,会话列表能看到本次访问。
- 视图与性能中能看到有样本的页面指标。
- 人为制造一次前端错误后,错误追踪中能看到聚合结果。上传对应版本的 SourceMap 后,详情中的栈更接近源码位置。
- 策略启用后,指标越过阈值时在告警列表出现记录。