故障排查¶

本文用于承载 C++ SDK 初始化异常、无数据与兼容性问题的排查建议。

初始化后没有数据¶

请优先检查以下内容：

1. 是否已完成 前置条件 中的 DataKit 安装、RUM 采集器配置和 IP 地理信息库安装
2. FTSDKConfig.setServerUrl 配置的地址是否可从当前设备访问
3. FTRUMConfig.setRumAppId 是否填写正确
4. 是否已经调用 sdk->install(...)、sdk->initRUMWithConfig(...)，以及对应的 Log / Trace 初始化方法
5. 是否在程序生命周期内实际触发了 View、Action、Resource、Error、LongTask 或 Log

调试日志检查¶

可通过 ft_sdk_config.json 开启调试日志：

{
  "general_config": {
    "enable_sdk_log": true
  }
}

建议在最小示例中先只保留 SDK 初始化与一次手动上报，确认基础链路可用后，再逐步增加业务逻辑。

RUM 无数据¶

请确认：

• 已正确设置 setRumAppId
• 已执行 sdk->initRUMWithConfig(...)
• 已手动调用 RUM 采集接口，具体可参考 自定义采集规则
• setSamplingRate 未被设置为 0

Log 或 Trace 无数据¶

请确认：

• 已分别执行 sdk->initLogWithConfig(...)、sdk->initTraceWithConfig(...)
• Log 已开启 setEnableCustomLog(true)
• Trace 已根据后端链路类型设置正确的 setTraceType(...)
• 如需在日志和链路中关联 RUM，请开启 setEnableLinkRUMData(true)

兼容性说明¶

当前 C++ SDK 文档明确支持以下平台：

• Windows
• Linux

如当前运行环境不在上述范围内，建议先确认 SDK 版本和平台支持情况，再评估接入方案。

自定义字段冲突¶

若上报字段异常或被覆盖，请检查是否与 SDK 内置字段重名。命名规则请阅读 冲突字段说明。