快速开始¶
本文用于提供 C++ RUM SDK 的最短接入路径，帮助您以最少步骤完成一次可验证的数据上报。
由于 C++ SDK 当前不提供自动捕获能力，完成初始化后，还需要通过手动调用 SDK 接口的方式上报 View、Action、Resource、Error 或 LongTask 数据。
前置准备¶
开始前，请先完成以下准备：
- 在用户访问监测中创建 C++ 应用，并获取
RUM App ID - 确认 DataKit 已安装并完成 RUM 采集器 配置
- 确认当前设备可访问
setServerUrl中配置的 DataKit 地址 - 完成 SDK 安装，具体方式请参考 应用接入
接入步骤¶
- 在工程中安装
datakit-sdk-cpp - 引用
FTSDKFactory.h - 初始化
FTSDKConfig - 初始化
FTRUMConfig - 通过手动调用 SDK 接口触发一次
View、Action、Resource、Error或LongTask上报 - 在控制台确认数据已成功接入
最小初始化示例¶
#include "datakit-sdk-cpp/FTSDKFactory.h"
//...
auto sdk = FTSDKFactory::get();
sdk->init();
FTSDKConfig sdkConfig;
sdkConfig.setServerUrl("http://10.0.0.1:9529")
.setEnableFileDBCache(true);
sdk->install(sdkConfig);
FTRUMConfig rumConfig;
rumConfig.setRumAppId("appid_xxxx");
sdk->initRUMWithConfig(rumConfig);
初始化后手动调用 SDK¶
完成初始化后，SDK 不会自动监听页面切换、点击行为或网络请求，需要您在业务代码中主动调用采集接口。
例如：
sdk->startView("main_view");
sdk->startAction("launch", "click");
sdk->stopAction();
sdk->stopView();
如需手动采集 Resource、Error、LongTask 等数据，请阅读 自定义采集规则。
可选：初始化 Log 和 Trace¶
如果还需要日志采集或链路追踪，可继续追加以下初始化：
FTLogConfig logConfig;
logConfig.setEnableCustomLog(true)
.setEnableLinkRumData(true);
sdk->initLogWithConfig(logConfig);
FTTraceConfig traceConfig;
traceConfig.setTraceType(TraceType::DDTRACE)
.setEnableLinkRUMData(true);
sdk->initTraceWithConfig(traceConfig);
验证接入是否成功¶
- 在
ft_sdk_config.json中开启enable_sdk_log - 运行程序，并在业务代码中手动调用一次
View、Action、Resource、Error、LongTask或Log接口 - 确认设备到 DataKit 的网络可达
- 返回控制台确认已出现对应的 RUM 或日志数据
如果需要进一步排查，请查看 故障排查。