빠른 시작¶
이 문서는 C++ RUM SDK의 최소 연결 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 전송을 완료할 수 있도록 합니다.
C++ SDK는 현재 자동 캡처 기능을 제공하지 않으므로 초기화를 완료한 후 SDK 인터페이스를 수동으로 호출하여 View, Action, Resource, Error 또는 LongTask 데이터를 전송해야 합니다.
애플리케이션은 Agent 자동 연결 및 수동 연결을 지원합니다. 다음 단계에서는 수동 연결의 최소 설정을 설명합니다.
사전 준비¶
시작하기 전에 다음 준비를 완료합니다.
- RUM에서 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 또는 로그 데이터가 표시되는지 확인합니다.
추가로 문제를 해결해야 하는 경우 문제 해결을 참고합니다.