故障排除¶

如何确定 RUM SDK 初始化成功¶

1、打开浏览器控制台：

2、检查对象 DATAFLUX_RUM 是否存在：

存在：

不存在：

3、执行DATAFLUX_RUM.getInternalContext()检查对象是否初始化成功：

如果初始化成功，则可以获取到当前应用页面对应的 session，application，view 等对象信息。

初始化失败¶

如果是以 CDN 的方式接入，确定当前应用是否为 https 站点；
确定配置是否正确, (包括配置参数的格式，以及名称)。

初始化成功，数据不上报、或者上报数据不全¶

检查浏览器版本信息，确定浏览器支持列表对应数据是否支持；
检查 RUM 浏览器 SDK 的初始化位置，并考虑在应用程序代码中尽可能提前执行初始化操作。

Session Replay 无法播放¶

页面提示“无回放数据”¶

依次检查：

sessionReplaySampleRate 是否大于 0；
是否在 SDK 初始化后调用了 startSessionReplayRecording()；
当前 SDK 版本是否支持 Session Replay；
DataKit 是否开启 session_replay_endpoints；
使用公网 DataWay 时，客户端是否可以正常访问数据上报地址；
当前 Session 是否因采样策略未采集回放数据。

页面提示“数据生成中”¶

说明回放数据已经进入处理流程，请稍后刷新页面。如果长时间未完成，请检查回放数据是否仍在持续上报。

页面提示“回放数据不完整”¶

可能是以下原因：

会话结束前部分数据尚未上报；
用户关闭页面或应用，导致缓存数据未及时发送；
客户端网络异常；
SDK 初始化或录制开始时间过晚；
数据上传被代理、防火墙或浏览器策略拦截。

页面提示“状态查询异常”或“回放文件获取异常”¶

先刷新页面并重新尝试。如果持续失败，请记录 Session ID、应用 ID、发生时间和页面错误信息，并联系技术支持。

接入和采样配置请参考如何接入会话重放。

XHR/FETCH 请求没有和 APM 链路关联¶

检查初始化配置中 allowedTracingOrigins 配置是否开启，确认格式是否正确。(如果以正则的方式配置，需确定数组里面配置的不是字符串，而是正则表达式)

正确 ```js datafluxRum.init({ applicationId: '', datakitOrigin: '', env: 'production', version: '1.0.0', trackInteractions: true, allowedTracingOrigins: [/https:\/\/.*\.my-api-domain\.com/] // 正则不能有引号 })

错误
 ```js
datafluxRum.init({
    applicationId: '<DATAFLUX_APPLICATION_ID>',
    datakitOrigin: '<DATAKIT ORIGIN>',
    env: 'production',
    version: '1.0.0',
    trackInteractions: true,
    allowedTracingOrigins: ["/https:\\/\\/.*\\.my-api-domain\\.com/"]
})

如何确认 APM 和前端 XHR/FETCH 关联成功¶

打开浏览器控制台；
确认 XHR/FETCH 请求的 Request Headers，是否包含对应请求头关键字信息，如下图为 ddtrace 相关请求头：